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Section 1 


GENERAL DESCRIPTION 


4907 FILE MANAGER 


The 4907 File Manager, the 4050 Series flexible disk storage system, adds several new 
commands to the 4050 Series Graphic System’s BASIC programming language. These 
commands, when used with regular Graphic System commands, allow: 


ө File naming 

ө File security with passwords 
ө Automatic increases іп file space when necessary 
® File copying 

ө Multiple file access 
€ Recording time and date of all file activities 

e File renaming 

€ Five file storage levels 

ө Fast access within files with “random” access 


The 4907 File Manager increases the potential and versatility built into your Graphic 
System. You'll find this product a valuable and efficient tool for your information storage 
activities. 


An enhanced version of the 4907 File Manager ROM Pack (available for the 4052/4052A 
and the 4054/40544) streamlines some of the 4907 commands, and adds some error 
handling commands. 


4052/4052A, 4054/4054A OPTION 27/28 
EXTENDED MEMORY FILE MANAGER 


The Extended Memory File Manager, a large block of semiconductor read-write memory 
(RAM) is housed in a four-slot backpack. The Extended Memory File Manager uses a 
Subset of the 4907 File Manager commands, so the memory acts like a very high speed 
disk drive. In most cases, a program which uses a 4907 can use the Extended Memory 
File Manager with little or no change. 


The Extended Memory File Manager may be used with a 4907, with a 4909 File 
Management System or alone. In any of these cases, the Extended Memory acts like a 
fourth disk drive on a 4907. 
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GENERAL DESCRIPTION 


The Extended Memory supports commands that, when used with the regular graphic 
system commands, allow: 


File naming 

Automatic increases in file space when necessary 

File copying within the extended memory (not to and from external devices) 
File renaming 

Multiple file access 

Very fast access within files 


The Extended Memory File Manager greatly increases the speed of programs and 
applications which make heavy use of disk space. You'll find that it makes many 
applications possible that were impractical using a conventional flexible disk drive. 


ABOUT THIS MANUAL 


This manual explains how to operate the 4907 and the Extended Memory File Managers. 


In order to use this manual and either of the File Managers effectively, you must have a 
working knowledge of the 4050 Series Graphic System. Most of the descriptions, 
procedures and terms in this manual have been written on that basis. 


Details of data transfer (I/O) and related subjects not covered in this manual are fully 
described in either the 4050 Series Graphic System Reference Manual or the 
4052A/4054A BASIC and GPIB Enhancements Programmer's Reference Manual. 


Your 4050 Series Computer together with the 4907 File Manager or the Extended 
Memory File Manager are referred to as "the system" throughout this manual. Your 4050 
Series Computer is often called a "host." Although the 4050 Series Computer is generally 
purchased separately, it is considered part of "the system" for purposes of discussion. 


Take time to familiarize yourself with the following information in the manual before 
attempting to operate the system. 
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GENERAL DESCRIPTION 


Front Panel Controls and Indicators (in Section 1) 


This portion of the GENERAL DESCRIPTION section describes the switches and 
indicators on the front of your system controller and disc drives. 


General Operation (Section 2) 


This section outlines the steps required before the system can be used, including GPIB 
cable & ROM pack installation, power up, and disk loading. It also shows you the steps 
that are necessary to create and use your first files. Review the GLOSSARY (Appendix D) 
to understand the terms used. 


Storage Structure (Section 3) 

This section describes the concepts of file storage. It is necessary to understand these 
concepts to write file identifiers (F.I.s), which are necessary parts of many commands. < 
How То Write А Command (Section 4) 

This section describes the basic rules for writing commands. It shows the general order to 
the fields and what they do. It also describes the terms used in individual command 
descriptions. 

How To Write A File Identifier (in Section 4) 

This part of Section 4 describes the rules for writing file identifiers. A file identifier, or F.I., 
is required in many commands. It helps to deliver information like an address on an 
envelope, but it can also create the destination (file). In short, the ЕІ. tells the Graphic 


System which file is involved in the operation and where it is to be created or where it can 
be found. 
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Command Descriptions (Section 5) 


4907 File Manager commands are described in Command Descriptions. 


Option 27/28, Extended Memory File Manager, Information (Appendix E) 
Appendix E contains the information about Option 27/28, the Extended Memory File 
Manager. This appendix contains general information on the Extended Memory File 


Manager, details of how the commands work, an explanation of the error messages, and a 
summary of specifications of the Extended Memory File Manager. 


Questions and Answers 
The following questions and answers may help you in using the manual. 
О. HOW DO! CREATE A FILE? 


A. Look in GENERAL OPERATION (Section 2) for the required steps. 


Q. WHAT KIND OF FILE SHOULD | USE? 


A. 4907 File Manager files are random or sequential and can contain either ASCII or 
binary data or programs. See RANDOM AND SEQUENTIAL FILES in GENERAL 
OPERATION (Section 2). Also see the descriptions of WRITE and PRINT in the 4050 
Series Graphic System Reference Manual. 


О. HOW CAN | BE SURE ГМ ENTERING COMMANDS IN CORRECT ORDER? 


A. Study the GENERAL SEQUENCE FLOW CHART in Section 2. You can see what the 
command parameters and prerequisites are, if any, by reading the command 
description. 


О. WHAT IS AN F.I. AND WHAT DOES ІТ DO? 


A. Тһе F.. or file identifier, is used in many commands to tell the system what the name 
of the file is and where it is to be placed or where it may be found if it already exists. 
See STORAGE STRUCTURE (Section 3) and HOW TO WRITE A FILE IDENTIFIER in 
Section 4. 


e C 
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. WHAT IS A CURRENT DEVICE? 


Commands containing logical file numbers or F.l.'s, but no device addresses, will be 
directed to the "current device." This device must be specified earlier in a UNIT or 
CALL "UNIT" command. 


. WHAT IS THE CURRENT LIBRARY? 


See CALL "USERLIB" command description in Section 5. 


. WHAT HAPPENS IF INCORRECT COMMANDS ARE ATTEMPTED? 


You will generally get an error message if incorrect commands are attempted. If 
strange results occur even though correct commands have been executed, the cause 
could include: 


€ accessing the wrong device 

€ not executing a UNIT command 

€ opening a file incorrectly 

€ using incorrect variables or variables already active in the Graphic System 
€ not executing an INIT when necessary 


In case of problems, check the command sequences required as well as the individual 
operations. Be sure the problem is not caused by incorrect use of the Graphic System 
or faulty programming. 


. HOW DO I GET DATA IN AND OUT OF MY FILES? 


See SAMPLE 1/0 in Section 2. 


. WHAT ABOUT PROGRAMMING? 


All normal Graphic System programming rules apply. No regular BASIC commands are 
disabled. See the program examples in INPUT and READ command descriptions in 
Section 5. Also see SAMPLE PROGRAMS, USING PRINT AND INPUT IN A PROGRAM, 
USING WRITE AND READ IN A PROGRAM, and SAMPLE I/O PROCEDURES in the 
appendices. 
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. WHAT ABOUT EXTERNAL DEVICES SUCH AS PRINTERS? 


. The system does not provide for “spooling;” that is, the devices or disc controller 


cannot listen or talk directly to other external devices. All interaction between the 
system and peripheral devices must go through the Graphic System. 


. HOW LARGE SHOULD | MAKE MY FILES OR FILE RECORDS? 


See the CREATE command description in Section 5. 


. HOW CAN I CHECK TO SEE HOW MUCH SPACE IS AVAILABLE ON A DISC? 


See CALL “DSTAT” command description. 


. HOW DO | RECOVER OPERATION IF EXECUTION IS HALTED AND AN ERROR 


MESSAGE APPEARS? 


Most error messages describe the error involved. For more details, see ERROR 
MESSAGES AND RECOVERY PROCEDURES (Appendix A). 


. CAN I USE THE 4907 WITH ANY GPIB TALKER? 


No. The GPIB device must be a controller; that is, talker and listener. 
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Figure 1-1. 4907 (Single Drive). 


Figure 1-2. 4907 Option 30 (Two Drives). 


Figure 1-3. 4907 Option 31 (Three Drives). 


REV, OCT 1982 


2380-50 


2380-51 


2380-52 


1-7 


GENERAL DESCRIPTION 


4907 CONFIGURATION 


All 4907 File Managers are designed for use with a TEKTRONIX 4050 Series Graphic 
System, which controls all storage activity (except for those procedures controlled by the 
front panel switches on the disc drives and disc controller). 


The 4907 File Manager includes a File Manager ROM (Read-Only Memory) pack and from 
one to three flexible disc drives. 


The ROM pack, which plugs into the Graphic System, provides extra BASIC commands 
for use by the Graphic System. These commands are transmitted from the Graphic 
System keyboard or program through a GPIB cable to the disc controller in the controller 
cabinet. The controller activates the single flexible disc drive in that cabinet and, if part of 
the system, one or two more disc drives in a second cabinet. These drives contain the 
flexible magnetic discs used for data storage. 


The 4907 File Manager is shipped in one of three configurations: 
® 4907 (single disc drive). 


€ 4907 Option 30 (two disc drives). 
ө 4907 Option 31 (three disc drives). 


Option 30 


flexible 
disc 
drive 


flexible 
disc 
drive 


flexible 
disc 
drive 


disc controller 


graphic 
system 


Option 31 
2380-53 
Figure 1-4. 4907 Configuration. 
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FRONT PANEL CONTROLS AND INDICATORS 


The following paragraphs illustrate the functions of the front panel controls and indicators 
for all configurations of the 4907 File Manager. 


4907 Controller and Single Flexible Disc Drive Cabinet 


2380-54 


Figure 1-5. Front Panel Controls and Indicators for 4907 Main Cabinet 
POWER INDICATOR. 
2. POWER SWITCH. 
3. BUSY INDICATOR. If this light is on, the system is performing a disc operation. 


4. FAULT INDICATOR. If this light is on, the system is inoperative. If restart efforts fail, 
see the 4907 File Manager Service Manual or contact Tektronix service personnel. 


5. FILE OPEN INDICATOR. If this light is on, one or more files on a disc are open. Some 
commands cannot be executed if files are open. See Prerequisites in COMMAND 
DESCRIPTIONS (Section 5). 

6. CLOCK INDICATOR. If this light is on, the system clock must be set. 


7. BUSY INDICATOR. If this light is on, this disc drive is in use. 


8. WRITE PROTECT SWITCH. A disc may also be write-protected by removing the tape 
from write-protect hole on the disc (see Figure 2-4 in Section 2, General Operation). 


9. WRITE PROTECT INDICATOR. If this light is on, the device or flexible disc is in the 
write-protect state. 


10. DRIVE DOOR RELEASE. Push in to open the drive door. 
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4907 Option 30 Single Flexible Disc Drive Cabinet 
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Figure 1-6. Front Panel Controls and Indicators for 4907 Option 30 Single Drive Cabinet. 


1. POWER INDICATOR. Even though indicator may be lit, the unit becomes inoperative if 
power switch on the main cabinet is turned off. 


2. POWER SWITCH. 
3. BUSY INDICATOR. If this light is on, this disc drive is in use. 


4. WRITE-PROTECT SWITCH. Disc may also be write-protected by removing the tape 
from the write-protect hole on the disc. 


5. WRITE-PROTECT INDICATOR. If this light is on, the device or flexible disc is in the 
write-protect state. 


6. DRIVE DOOR RELEASE. Push in to open the drive door. 
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4907 Option 31 Dual Flexible Disc Drive Cabinet 


2380-56 


Figure 1-7. Front Panel Controls and Indicators for 4907 Option 31 Dual Drive Cabinet. 


1. POWER INDICATOR. 
2. POWER SWITCH for both drives. 
3. Left DRIVE DOOR RELEASE. Push in to open the drive door. 


4. WRITE-PROTECT INDICATOR for left drive. If this light is on, device or flexible disc is 
in the write-protect state. 


5. WRITE-PROTECT SWITCH for left drive. 


6. BUSY INDICATOR. If this light is on, the system is performing an operation on the left 
drive. 


7. BUSY INDICATOR. If this light is on, the system is performing an operation on the 
right drive. 


8. WRITE-PROTECT SWITCH for right drive. 


9. WRITE-PROTECT INDICATOR for right drive. If this light is on, device or flexible disc 
is in the write-protect state. 


10. Right DRIVE DOOR RELEASE. Push in to open the drive door. 
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STANDARD/OPTIONAL ACCESSORIES 


All 4907 File Manager systems come with the standard accessories listed directly below. 
The systems with Option 30 or Option 31 contain additional standard accessories which 
are listed under those headings. 


4907 Standard Accessories 


4907 File Manager Operator’s Manual 
Power Cord 

1 Flexible Disc 

Box of Cleaning Pads (10) 

GPIB Cable (2 meters long) 

4907 Installation Guide 

4907 File Manager Pocket Reference Card 
4051 File Manager ROM Pack 


4907 Optional Accessories (All Options) 


Box of Flexible Discs (10) 

4907 Service Manual 

GPIB Cable (4 meters long) 

Flexible Disc Drive Service Manual 

Alignment Disc 

Option 40 (4052/4054) File Manager ROM Pack 


4907 Option 30 Standard Accessories 


Power Cord 

Interconnect Cable 

Strain Relief Bracket 
Clamp 

1 Flexible Disc 

Box of Cleaning Pads (10) 
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4907 Option 31 Additional Standard Accessories 


Power Cord 

Interconnect Cable 

Strain Relief Bracket 
Clamp 

2 Flexible Discs 

Box of Cleaning Pads (10) 


4907F32 Field Upgrade Kit Standard Accessories 


This kit is used to add a drive to a two-drive system; this creates a system identical to the 
4907 Option 31. The 4907F32 kit includes these accessories: 


1 Flexible Disc 
Box of Cleaning Pads (10) 


The 4907F32 Kit includes these components: 


Drive Kit 

Front Panel 

Wire Kit 

Ribbon Cable, 50 Conductor 
Ribbon Cable, 40 Conductor 
Write-Protect Switch with Bezel 
LED for Write-Protect Switch 

LED (Busy) with Recessed Washer 
Cable Ties (2) 
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INTRODUCTION 


This section outlines the steps you must perform before the 4907 File Manager can be 
used, including GPIB cable and ROM pack installation, power up, and disc loading. It also 
shows the steps that are necessary to create and use your first files. Review the 
GLOSSARY (Appendix D) to understand the terms used. 


NOTE 


To protect your operations from loss of data contained on 4907 File 
Management System diskettes, see ENSURING DATA RELIABILITY later in 
this section. 


PREPARATION 


Certain preparatory steps must be performed before the 4907 File Manager can be used. 
First, if necessary, you must change the address strap and line voltage. Next, install the 
line cord or cords, ribbon cable (not applicable to the single disc drive 4907), ROM pack, 
and GPIB cable. Last, power up the system, load the discs and execute performance 
checks. 


These preparatory steps are described in the 4907 Installation Guide, and when they 
have been performed, the File Manager is ready for use. 


NOTE 


Because GPIB cabling, ROM pack installation, power up, and disc loading 
are regularly repeated operations, they are included in this manual as well 
as in the 4907 Installation Guide. 
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GPIB Cable and ROM Pack Installation 
1. Turn off the Graphic System. 


2. Connect the GPIB cable from the rear of the Graphic System to the rear of the 4907 
main cabinet and tighten both screws on the connector. (Figure 2-1). 


3. Plug the File manager ROM Pack into the Graphic System backpack slot shown in 
Figure 2-2. Do not plug the ROM Pack into a ROM Expander unless ROM Expanders 
are connected to all backpack slots. BE SURE THE GRAPHIC SYSTEM IS TURNED 
OFF. If the Graphic System has the standard two-slot backpack, you should use Slot 
41 (Figure 2-2A). if the Graphic System has the optional four-slot backpack, you 
should use Slot 61 (Figure 2-2B). 


NOTE 


Whenever GPIB cable is disconnected from 4050 series instrument, be 
sure to remove ROM Pack as well. Otherwise, when any other instrument 
asserts SRQ, the 4050 series instrument will hang busy. 


[© 
le 


2380-57 


Figure 2-1. Connecting GPIB Cable to Rear of 4907 Main Cabinet. 


Inserting any device into or removing any device from a Graphic System 
backpack slot ога ROM Expander slot when power is on may cause 
memory to Бе erased. 
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NOTE 


Only one File Manager ROM pack may be piugged into a single System. 
Installing more than one of these ROM packs sets up a conflict since each 
4907 would be considered GPIB device 0. 


A. TWO-SLOT BACKPACK: 
USE SLOT 41 


SLOT 61 


B. FOUR-SLOT BACKPACK: 
USE SLOT 61 


Figure 2-2. Plugging in ROM Pack. 


If multiple GPIB devices are connected to the Graphic System, at least half 
of them, plus one, must be turned on before turning on the Graphic 
System. If this is not done те І/О indicator may light continuously and the 
system will not operate. The devices must be turned on, even if they are 
not going to be used, otherwise, they must be disconnected. 


Power Up 
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4907 (Single Drive) 
1. Turn on the front panel power switch on the тат 4907 cabinet. 


2. Turn on the Graphic System. 


4907 Option 30 and 4907 Option 31 
1. Turn on the front panel power switch on the auxiliary cabinet. 
2. Turn on the front panel power switch on the main 4907 cabinet. 


3. Turn on the Graphic System. 


Never attempt to use a two-cabinet system without applying power to both 
cabinets. Be sure the green POWER ON indicator is lit on both cabinets 
before mounting disc on either one. If a disc is mounted in one cabinet 
while the other is not powered, data on the mounted disc may be 
destroyed. 


2380-59 Q 
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Figure 2-3. Placing Flexible Disc in Drive. 


1950-37 


Figure 2-4. Flexible Disc Write-Protect Hole. 


Loading the Flexible Disc 


1. Press drive door release on front of drive and place flexible disc in cavity as shown 
(Figure 2-3). Slide disc, with label up, as shown in Figure 2-3, as far in as it will go or 
until you feel a "click". Be sure the tape supplied with the disc is covering the write- 
protect hole whenever formatting or writing to a disc (Figure 2-4). To write-protect a 
disc, remove the tape covering the write-protect hole. 
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Figure 2-5. Closing Drive Door. 


2. Close Door (Figure 2-5). 


3. Repeat sequence with additional drives, if necessary. 


Ensuring Data Reliability 


The best way of ensuring data reliability and to protect your operations from loss of data 
is: 


a) Back up diskettes. 


b) Protect diskettes when not in use. 
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c) Do not use excessively worn diskettes for critical applications. 


d) Keep the 4907 File Management System in proper working order including proper 
calibration. 


Data Back-Up 


Data stored on a 4907 File Management System diskette can be lost due to diskette 
failure, data overwrite, or accidental deletion of files by programs or operators. Here, we 
are not concerned with data capture or data generation, but loss of data that has been 
previously stored on a diskette. The only practical method of protection from data loss is 
to make back-up copies of the data. 


Using a 4050 Series Graphic Computing System and 4907 File Management System 
allows data back-up on diskette or 3M magnetic tape. 


Back-Up on Tape 


The easiest way to back-up data from diskette onto tape is to use the internal 4050 
Series tape drive and a 3M tape (as the archive device and media). A specific set of 
utilities is available from Tektronix: Disk-to-Tape Back-up/Restore Utilities. These utilities 
were designed specifically for owners of a single-drive 4907 File Management System 
who need to back up information from their diskettes onto tape; see Applications Library 
Program Documentation: Utility T1. Using these utilities, all file types supported by the 
4907 File Management System can be archived or restored using the internal 4050 
Series tape drive. 


Back-Up on Diskette 


If two diskette drives are available, the 4907 File Management System COPY statement 
сап be used; see Section 5, COPY ... TO in this manual. The COPY statement will 
perform diskette-to-diskette copies. 


If only a single drive is available, and you want to use a diskette as back-up, the tape 
back-up and restore procedures can be used in a two step operation: 


a) With the main diskette in place, perform diskette-to-tape back-up. 


b) Remove the main diskette, replace it with the back-up diskette, and then do a 
tape-to-diskette restore. 
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How Often or When Should Back-Up Be Performed? 


There is no hard and fast rule to this question. It is a function of several main factors, the 
most important of which is, how important is the data in question to your operations? A 
related question is, how hard would it be to replace the data? The more important the data 
or the harder it is to replace, the sooner it should be backed up. Remember that a diskette, 
program, or operator failure can occur at any time. 


Ensuring Maximum Diskette Life and Reliability 
The more a diskette is used, and the older it gets, the more likely it is to fail (wear out). 
There are several things you can do to prolong or maximize the life of a diskette and 


thereby maximize the diskette data reliability: 


€ Do not place heavy objects on diskettes. 


Use only felt tip (or other soft tip) pens to write on diskette labels. 


Do not touch the diskette data surface. 


Store diskettes in their protective covers and place them in an upright (vertical) 
position. 


ө Observe the environmental limits of diskettes — do not expose them to high heat, 
high humidity, low temperatures, sunlight, etc. 


€ Keep diskettes away from magnetic fields when outside the 4907 File Manage- 
ment System. 


€ Do not leave diskettes in a drive when not in use. This includes not leaving them 
hanging half in and half out of a drive. 
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1 
Ф. 
п 
! | Static Electricity 
1 Static electricity can destroy data stored оп a diskette and possibly even destroy a small 
t 


area on the surface of the diskette. 
i Carpeting and items of clothing can generate static electricity. 
і 


If you walk across the floor with a diskette in hand, be sure you discharge апу static 
electricity — using your free hand — before you touch the diskette to any metal surface 
(such as the drive). You also need to be careful before picking up a diskette from a metal 
т surface where a static electricity arc might occur. 


~ 
—2 


Assessing Diskette Condition 


222 


Тһе main method the 4907 File Management System has of assessing a diskette’s 
physical condition is a long format; see CALL “FORMAT” in this manual. A long format 
writes a special data pattern, parity bit, etc., on each block (sector) of the diskette, and 
then attempts to read each block back; it is a format of the diskette as well as a surface 
analysis. Any block it cannot successfully read back means that that block is bad. 


^] 


е е 


2 


Remember: 


222 


® A long format destroys all data оп а diskette. 


Using the message received after a CALL “MOUNT” statement (a Device Status 
Message), you сап get the values for SIZE and FREE. 


222 


SIZE is the number of bytes available on a perfect diskette; it is а constant equal to 
630784 (bytes) for each diskette. 


LI 


FREE is the number of free (unused) blocks still available for use. 


2-2 


Each diskette block contains 256 bytes. Block zero (0) is always used for system 
requirements. After a long format, the only block not free on a diskette with all good 
blocks is block zero. Therefore, if the calculation SIZE-FREE yields a result other than 
256, you know there was one or more bad blocks. In other words, after a long format with 
no bad blocks detected, SIZE will equal 630784 and FREE will be 630528 (630784-256); 
any other result means bad blocks were found. The number of bad blocks can be 
calculated by: 


мро Malden | 


> 


dl 
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Bad blocks = (SIZE-FREE-256)/256 


Remember this is true only after a long format and before any files are created on the 
diskette. 


NOTE 


Be wary of a diskette that formats with bad blocks and do not use it for 
critical applications. 


A Clean and Calibrated Diskette Drive 


A clean diskette drive will minimize any data reliability problems; see Section 6, Routine 
Maintenance. 


Diskette drives should be kept in calibration; consult the 4907 File Manager Service 
Manual or your local Field Service Office. 


Pre-Warning Conditions 


When the 4907 File Management System is reading data, it does not give up if the first 
attempt to read a block is unsuccessful. In fact, it will try 10 times before it stops and 
indicates the error to the user. Anytime the 4907 File Management System cannot read a 
block correctly the first time, it goes into a reread mode. Part of the reread process is to 
accumulate, as a running total, the number of rereads since power was applied to the 
system. Reread totals are independent of which diskettes or drives the rereads occurred 
on, і.е., totals are system totals. You can find out the total number of rereads by using the 
CALL "HERRS'" statement; see CALL “HERRS” (Hard Error Status) in this manual. 


If a large number of rereads are taking place in a 4907 File Management System, there 
are problems somewhere in the system. It could be due to one or more diskettes going 
bad, a write problem, calibration problem, etc. In any event, a large number of rereads 
indicates the system is in a degraded (far from optimal) condition and needs attention; the 
offending problems need to be found and corrected or data will start being lost or the 
system will fail completely, etc. 
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GENERAL SEQUENCE FLOW CHART 


zd 


The general sequence flow chart at the back of this manual (Figure 2-6) shows the steps 
necessary in creating and using files. The accompanying text explains the important 
details of File Manager operation. 


~ 
чары 


HOW ТО СЕТ STARTED ON THE FILE MANAGER 


3 


<-> 
— - 


Once the system is powered up, the following steps will get the 4907 up and running. (Be 
sure to press the RETURN key after each line of text that is entered on the Graphic 
System keyboard.) 


1. LOAD THE DISC. 


ша LJ 


Place a blank flexible disc in drive O. Be sure the write-protect switch is off and 
the tape is over the write-protect hole on the disc. (See Figures 2-3 and 2-4.) 


222 


2. Enter INIT (that is, type INIT оп the Graphic System keyboard and press the 
RETURN key). 


222 


2 


This initializes the system and sets all variables to an undefined state. 


222 
о 


. Enter CALL "SETTIM","DD-MON-YY HH:MM:SS”. 


This command, with the current date and time, sets the system clock. 


ша 


4. Епїег О!М А$(200). 


2222 


This command increases the size of A$ to allow room for the status message. 


. Enter CALL “DRES”,0. 


а 


This command reserves drive О for your system. 


22 22 
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6. Enter CALL ‘“FORMAT”,0,“COMPANY”,1,1,“YOUR 


NAME” ,“MSTRPSWRD‘“,1,10,1,1,1 
This formats the disc in device 0. This means you are giving it its own 
identification. 
NOTE 
Be sure to write down your password. This password can be used with the 


KILL and CALL "MRKBRG" commands. 


Formatting a disc takes about two minutes. When formatting is complete, 
the busy light on the drive goes off. 


. Enter CALL “DREL’’0. 


This command releases drive O. 


. Enter CALL “ОЗТАТ”,0,А$. 


This command asks the system to send a message about the disc to А$. 


‚ Enter AS. 


Тһе device status message appears. А typical message looks like this: 


967 DEY ID COMPANY VOL ID ‘YOUR NAME OWNER 
630528 FREE 630784 SIZE 89 LOST 256 BLK SIZE 
24-AUG-78 99:48 FORMATTED 8 FILES OPEN 


This message shows the name of the disc (ID) the owner's name, how many bytes are 
available, etc. See Appendix A for a more complete explanation. 


Once your disc has been formatted, the start-up procedure is as follows: 
1. Place the formatted disc in drive 0. 


2. Set the system clock (if necessary) using the “SETTIM” routine. 
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3. Dimension A$ to 200 (if necessary). If error message 9 results, A$ is already 
defined; use a different string name (i.e.,B$). 


4. Enter CALL “MOUNT” О,А$ (ог В; whichever you wish to receive the device 
status message for this disc). 


Once a disc is mounted (the FORMAT routine automatically mounts the disc), files can be 
created on the disc. To store a program on the disc, first load a program into system 
memory from a tape or enter it from the keyboard; then enter SAVE “FILE”. Your program 
is now stored on the disc in the file named FILE. For program files, you do not need to 
"mark" the size of the file (as you must for magnetic tape files). 


To retrieve the program from the disc, enter OLD "FILE". 


SAMPLE I/O 
To store data sequentially on the disc, use the following sequence: 
1. Place a formatted disc in drive 0 and mount it. 
2. Enter CREATE "DATAFILE"; 200,0. 
This creates a file 200 bytes long on your disc. 
3. Enter DIRECTORY 2, "DATAFILE". 


The file status message for the file DATAFILE is displayed (see Appendix A for a 
more complete explanation): 


SCRATCHLIB/DATAFILE 
B K SC N ATR 254 ALLOC 24-NOU-78 13:22 ALT 
@ USED 24-NOU~78 13:22 USED 
0 ОРЕН € REC LEN 24-NOU-78 13:22 CREATED 


4. Enter Z6=“SMITH & JONES 12345” and ZO=12345. 
5. Enter OPEN "DATAFILE"' 1,"F",AS. 


This command opens the file and assigns the logical file number (Ifn) 1 to this file. 


6. Enter WRITE #1:Z$,ZO. 


This command sends the string Z$ and the variable ZO in binary format to Ifn 1 
(values are stored in ASCII format by using the PRINT command). 
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т. Enter CLOSE 1 to close Ifn 1. 


The string “SMITH & JONES 12345” and the number 12345 now reside in the file. 


To access these values, enter: 
OPEN “DATAFILE”;1,“F”,AS 


READ #1:X$,B3 
CLOSE 1 


NOTE 
Opening a sequential file for “Full” access positions a pointer at the first data item 
in that file. As items are retrieved, the pointer points to successive data items. If 


the file is closed before the pointer reaches the end of the file, all items after the 
pointer are lost. 


The previous example created a binary sequential data file. Data files can be either 
random or sequential. This example creates ап ASCII random file. 
1. Enter CREATE "ASCIRNDM","A";20,31. 
This command generates an ASCII file named ASCIRNDM which consists of 20 
records (where each record is 31 bytes long). See FILE OR FILE RECORD SIZE 
REQUIREMENTS under the CREATE command description for a discussion of 


space requirements. 


іп order to store data randomly to a random file, the file must first be “initialized”. 
Initialization in this case means filling each record with blanks. 


2. Enter OPEN "ASCIRNDM'';1,"F',AS. 
This command opens the file and assigns № 1 to it. 


3. Enter Z$ =“ ”, inserting 30 blanks between the quotation marks. 


To verify that Z$ contains 30 blanks, enter LEN(Z$). The value returned equals the 


number of characters in Z$. 


4. Enter PRINT #1,1:Z$. 


This command stores the contents of Z$ in record 1 of Іп 1. 
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5. Enter PRINT #1,2:2$. 
This command stores the contents of Z$ record 2 of № 1. 


Enter a print statement for all 20 records of ASCIRNDM (for example, with a FOR .. NEXT 
loop). 


To store numeric or string data in ASCIRNDM, enter: 
PRINT #1 1: «variable or variable name> 
where l is a record number. 
To retrieve data, enter: 
INPUT 51,1: «variable name> 


where | is the record number. If the named variable is X$, the data string is stored іп X$. 


NOTE 


2 


For ASCII random files, even though they must be initialized, the End of 
Record characters are ASCII characters. It is therefore possible to read 
past the end of a record (i.e., if there are more variable names in your 
INPUT statement than there are data items in that record). End of Record 
characters will not transfer contro! to ON EOF... THEN ... statements. 


The following program shows the basic steps necessary to create files and write and 
print to those files. It also shows how to retrieve and print the information stored in those 
files. 


If error messages occur, check ERROR MESSAGES AND RECOVERY PROCEDURES 
(Appendix А). Be sure that all entries are correct and that al! preparatory steps described 
earlier in this section have been performed. 


2 
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A description of the program operations and a sample of the program output follow the 
program listing below. 


180 INIT 

195 REM: THIS PROGRAM DESTROYS CURRENT DISK DATA 

116 DIM R$¢2000>,.F$¢200) 

120 CALL "TIME",R$ 

130 IF LENCR$)>6 THEN 170 

140 PRINT "ENTER DATE AND TIME «DD-MON-Y'Y HH:MM:SS5:"; 
158 INPUT A$ 

168 CALL "SETTIM",R$ 

170 PRINT v МАНУ DEVICES ON YOUR SYSTEM?:"; 


P 
220 FOR 1=1 ТОН 
236 PRINT "JJTHIS IS A SAMPLE PROGRAM FOR DEVICE “СІЗ; "J" 
248 CALL “UNIT",DCTD 
259 CALL “DRES",DCI> 
260 CALL “FORMAT”, DCI», SAMPLE", 1,1, "OWNER", "Ра55",1,10,1,1,1 
276 CALL "DREL", PCI? 
280 CREATE "АЗС, "A" 3140 


390 OPEN "ASCFILE"31,"F",F$ 

310 PRINT #1: "THIS IS AN ASCII SAMPLE (SEQUENTIAL FILE?” 
320 OPEN "BINFILE":2."F",F$ 

330 WRITE 182,1: "THIS 15 A BINARY SAMPLE (RANDOM FILED" 

340 CALL "REMWIND",1 

350 INPUT #1:5$ 

360 PRINT 5$ 

370 READ #2,1:S$ 

380 PRIHT $$ 
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Program Description 


100 Initialize 
110 
120 
130 
140 
150 Set system clock, if necessary 
160 
170 
180 Enter the total devices on your system (1, 2, or 3) 
190 
200 
210 Enter the device addresses (0 or 0, 1, etc.) 
220 
230 Print heading 
240  Setunit number 
250 
260) Format disc 
270 
280 Create an ASCII, sequential file 
290 Create a binary, random file 
300 
ч Open each file and store message 
320 
330 
340 Rewind sequential file 
350 
360 Access files and display messages 
370 
380 
390 Close both files 
400 
410 End program 
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Sample Program Output | 


CZ 


RUN 

ENTER DATE AND TIME ©рО-МОН-ҮҮ HH:MM:SS5:12-DEC-?? 08:30 
HOW MANY DEVICES ON YOUR SYSTEM?:1 

ENTER DEVICE ADDRESSES:6 


Гг. 


THIS IS A SAMPLE PROGRAM FOR DEVICE 0 


FORMAT REQUESTED. ОК TO DESTROY DATA ON DEVICE В?Ү 
THIS IS ЯН ASCII SAMPLE “SEQUENTIAL FILE? 
THIS IS A BINARY SAMPLE (RANDOM FILE) 


г CZ 


RANDOM AND SEQUENTIAL FILES 


All 4907 File Manager files cover specific areas of specific length on the disc recording 
surface. The location and size is specified in the CREATE command. There are two basic 
file forms — sequential and random. 


ЕЕ 


C 


Sequential Files 
A sequential file may be pictured as a long empty space with no divisions: 


BEGINNING OF FILE 


File length specified » A 
| in CREATE command 


Information is entered sequentially. This means it must start at the first empty space and 
work towards the end of allocated space. The first empty space may be at the beginning 
of the file or just past the last data entered. Information retrieval also must be sequential 
and must start at the beginning of the file. Sequential files are useful in storing entire 
programs or data items that are best accessed one after another. Sequential files may be 
generated on discs and Graphic System magnetic tapes. 


C 


Ел г 1— ЕР о єс. єс o EI 
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Random Files 


A random file is similar to a sequential file except that it is divided into two or more 
sections or “records.” 


pu OF FILE SIZE AND NUMBER OF RECORDS 
SPECIFIED IN CREATE COMMAND 


RECORD 
#1 


The size and number of these records аге specified т а CREATE command. These 
records, which may be as small as one byte in length, are numbered. Information may be 
entered into or retrieved from any record in the file by specifying that record number in 
the МО command. This means that data as small as a single character or number may be 
written or read or printed or input immediately without a sequential search. Data in each 
record cannot be "added to." Each time new information is entered into a record, it 
completely replaces existing information. Information in all other records in the file, 
however, remains unchanged. 


Random files may be created only on 4907 File Manager discs. They cannot be generated 
on the Graphic System internal magnetic tape. 


NOTE 


Files are specified random or sequential in the CREATE command. 


SPECIAL SYSTEM FEATURES 


Special 4907 File Manager features are listed below with the associated commands. See 
COMMAND DESCRIPTIONS (Section 5) for specific command details. 


System Clock 


When files are created, altered, or used, the date and time of the activity are automatically 
recorded for that file. 


The date and time of the last disc formatting are recorded on the volume label. 
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Command involved: 


CALL “SETTIM” 


Automatic File Extending 


Whenever data is sent to a file requiring more than the allocated space, the system 
automatically extends the file to accommodate the extra data. 


Commands involved: 


WRITE 
PRINT 
SAVE 


Status Messages 


Whenever it is necessary to check the status of a file or device, special commands may 
be executed which return status messages. These messages include time/date informa- 
tion, space specification, identification, etc. See DEVICE AND FILE STATUS MESSAGES 


(Appendix A). 
Commands involved: 


CALL "CUSTAT" 
CALL "FILE" 
CALL "MOUNT" 
CALL "DSTAT" 
DIRECTORY 
OPEN 


Special Characters 


Special characters in file identifiers simplify writing Ғ.1.6 and the search for files or groups 


of files. They are also useful in accessing certain kinds of libraries. See SPECIAL 
CHARACTERS IN FILE IDENTIFIERS in Section 4. 
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“Group” Open/Next File 


Sometimes you may need to access several files consecutively. Normally, this would 
require a separate OPEN for each file. However, with the use of SPECIAL CHARACTERS, 
groups of files may be selected, opened, and used with a single OPEN. This kind of OPEN 
command is called a “GROUP” OPEN and requires that а “С” is entered in the command. 
After the first file in the group is opened and used, CALL “NEXT” closes that file and 
opens remaining files one by one. 


Commands involved: 


OPEN 
CALL “NEXT” 


NOTE 


Only one “GROUP” file can be opened at a time. Opening more than one 
“GROUP” file will generate a table exhausted error message. 


Free Space Message 


The amount of remaining storage space on any disc (in bytes) may be seen by requesting 
a device status message. 
Commands involved: 


CALL “СУЗТАТ” 

CALL “DSTAT” 

CALL “MOUNT” 
Random Access 


Unlike files on magnetic tape, disc files may be created for random or "direct" access. 
This means that the file may be divided into numbered "sections" or records as small as 
one byte. By entering the number of that record in ап МО command it can be directly 
accessed without the need of stepping through the data items one by one. This can 
greatly speed МО activities. You can specify the disc files to be random or sequential in 
the CREATE command. 


Simultaneous File Use 


Once the system is notified which drive is to be accessed, up to nine files may be opened 
and used. See OPENING MULTIPLE FILES in the OPEN command description. 


Commands involved: 


UNIT 
CALL "UNIT" 
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STORAGE STRUCTURE Page 
Тое Те оО 3-1 
What is a Storage бігисінге?................................ 3-1 
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INTRODUCTION 


This section describes the concepts of file storage structures. These concepts are helpful 
when you begin to write file identifiers (F.l.s) which are а part of many commands. 


WHAT IS A STORAGE STRUCTURE? 


When data or program information is sent to a disc, it is stored т a "file" that occupies a 
portion of the disc. Usually each file contains different information. Often, however, 
several files may contain similar information. As a result, it may be desirable to group files 
into categories, and then collect the categories into groups, and so on. This way it is 
easier to keep track of and recover all information. When one or more files are placed on 
the disc, or when file grouping is carried out, a "storage structure" is formed. To illustrate 
what "storage structure" is and why it is a useful concept, Figure 3-1 shows a "storage 


structure" containing a single file. 


2380-14 


Figure 3-1. Sample Storage Structure (1 Level). 
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If another file is added, the structure in Figure 3-2 results. 


2380-15 


Figure 3-2. Sample Storage Structure (1 Level). 
NOTE 


The Extended Memory File Manager (Options 27 & 28) supports only a 
single level storage structure as in Figure 3-2. When the Extended Memory 
encounters a library name or password, it will be ignored. 


The Extended Memory File Manager "folds" a multiple level storage 
structure to a single level by ignoring library names. This can cause 
problems if files in different libraries have the same name. 
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So far there are two files stored on the “1st level”. The 4907 File Manager System 
provides five storage levels. If several files sharing a common characteristic or belonging 
to a particular user are added, they may be grouped under a “LIBRARY.” If a library is 
used, the files will be placed on the next level; for example, three files grouped in a 1st 
level library will be placed on the 2nd level as shown in Figure 3-3. 
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22 
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Figure 3-3. Sample Storage Structure (2 Levels). 


ian 
У 


A library is a “heading” and сап only be used to reference other libraries or files on lower 
levels. See the CREATE command to see how libraries are specified. A library can never 
be used to hold data or programs, nor can a file ever reference another file or library. For 
example, if two groups of files were stored on the 5th level, there must be preceding 
libraries on the 4th, 3rd, 2nd and 1st levels. The storage structure in Figure 3-4 shows 
what this might look like if these 5th level files were added to the sample storage 
structure in Figure 3-3. 


a 23 -3 
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EA E ЕСІ E 1st level 
E | зе | | те | | library | 2nd level 

| brary | 3rd level 

ELS | library | 4th level 
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Figure 3-4. Sample Storage Structure (5 Levels). 


Remember: 


Ф The only purpose of libraries is to allow grouping of files or libraries on 
subsequent levels. As a result, no libraries may be placed on the 5th level. 


e Files never have subsequent files or libraries. 


ө There is no limit (other than space restrictions) to the number of libraries or files 
on a particular level. 


e Storage structures are limited to five levels. 


х2 
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When separate discs are dedicated to an individual subject or user, 
л storage structures сап be very simple because fewer storage !еуе!$ are 
А necessary. For example, а ѕіпд!е disc with two libraries (ignoring те 


standard first level libraries: SYSLIB, USERLIB and SCRATCHLIB) contain- 
ing two files each will have a storage structure like this: 


24 c3 22 
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Three discs with only two files each һауе a much simpler structure: 
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Section 4 


HOW TO WRITE A COMMAND 


SYNTAX 


4907 File Manager commands, like other Graphic System BASIC commands, must be 
written in a specific manner. The fields required for each command must be in proper 
order, and the information entered in those fields must be of the type specified in the 


description. Generally, each command contains one or more of the following fields in the 
order shown: 


KEYWORD and ADDRESS and/or ARGUMENT 
(or keywords) (or addresses) 


Keyword 


The command keyword tells the system what kind of activity is to be carried out. The 
entry may be abbreviated as shown in the description of that command. Two keywords 
are required for some commands. Some keywords are preceded by the word CALL. 
Keywords preceded by CALL must always be in quotes; for example, CALL "DSTAT". 


Address 


The address tells the system the location of the device, the location of the file, or both. In 
some cases, two addresses are necessary because two devices or files are needed. The 
different types of addresses required are as follows: 


device address This number, which must be an integer from O to 255, tells the 
system which device it will be communicating with. 


F.I. File identifier. This combination of names tells the system the 
location and identity of the file or files on the disc. 


HOW TO WRITE A FILE IDENTIFIER (later in this section) and 


STORAGE STRUCTURE (Section 3) provide discussion of Е 1. 
requirements and storage structure. 
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C 


Мп Logical file number. The integer, from 1 to 9, entered in this field 
is specified in an earlier OPEN command and represents BOTH 
the device address and the F.I. The main purpose of an Ifn is to 
make it unnecessary to include both the device address and the 
F.I. in subsequent commands. In some commands the їп must 
be preceded by # (pound sign) as shown in the description of 
that command. : 


МО address The I/O address tells the system what device, other than the 
Graphic System display, is to receive file status messages and 
what action is required. Ап I/O address may be specified only in 
the DIRECTORY command. 


L 
L 
L 
Ш 
L 
L 


Е 


Only the CALL “SETTIM”, DELETE ALL, CALL "CUSTAT", CALL "FMVALS", SECRET, 
CLOSE, and CALL “TIME” commands do not require an address of some kind. This is 
because they set or reflect parameters affecting the entire system. 


Argument 
Those fields not containing keywords or addresses are considered “argument” fields. The 


argument may tell the system where to send the information that the command is 
generating, as in this example: 


C 
с. EL. а 


CALL “ОЗТАТ”,2,А$ 


Е. 


The last field, or argument, tells the system to send the device status message that this 
command generates to A$ in the Graphic System memory. 


The argument may be used to supply information for command execution rather than to 
store the results. The “2” in the preceding command specifies drive 2. 


Some commands, such as CALL “FORMAT”, have many argument fields; others, such as 
CLOSE, may have none. 


Е. Е 


C 
т 
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CLASSES OF FIELDS 


As you read the syntax forms in COMMAND DESCRIPTIONS (Section 5), you will see the 
fields are specified as one or more classes. An entry in any field must fit one of those 
classes. Each class is described below. 


Constant 


А constant entry must be a positive integer and cannot be represented by a variable. 


String Constant 


A string constant entry must be the string required for that field and CANNOT be 
represented by a string variable (such as A$). All string constants must be placed in 
quotation marks (“DOCTORX”) when entered in a command.’ In some cases, you must 
make a choice between a few single character constants. Those choices will be shown 
instead of the term "string constant” within brackets, like this: 


8 E 
“в” 
“с” 
Numeric Expression 
A numeric expression may be any of the following: 
Numeric constant, such as 3 
Numeric variable, such as M 
Subscripted array, variable such as B(1),B(1,1) 
Logical or relational comparison enclosed in parenthesis, such as, 


(A or B) 
(A > B) 


Valid combination of the above 


б 


1When a series of string constants are used in an Ғ.І., only a single set of quotation marks around the 
entire Р.І. is necessary. 
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Numeric Variable 


The entry may be any numeric variable allowed in regular Graphic System operation. If a 
numeric variable is entered, it must have a value already defined. 


String 


The entry may be a string (“DOG”) or a string variable representing that string (A$). Any 
string must be preceded and followed by quotation marks when entered in either the 
command or stored in a string variable as shown here: 


A$ = “FINANCE” 


String Variable 


The entry may be any valid string variable allowed in regular Graphic System operation 
(e.g., A$, B$). 


All string variables must be dimensioned if more than 72 characters аге required to 
contain the information generated by the command. See the 4050 Series Graphic System 
Reference Manual. 


Target String Variable 


Usually, when string variables are used in a command, they already contain data to be 
used by that command — but not always. In some command descriptions you will see the 
term “TARGET STRING VARIABLE.” In these cases the string variable is redefined at the 
time of command execution, and the data generated by the command is sent to this target 
String variable. 


The following command example is written with an integer, a string and, in the last field, a 
target string variable: 


CALL "FILE",S,"MYLIBRY/FILE", AS 


The target string variable (A$) is the destination of the message generated by this 
command. 


If the target string variable already contains data, it is replaced by the new data when the 
command is executed. 
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Target Numeric Variable 


The numeric result of a command is sent to a target numeric variable. 


COMMAND DELIMITERS, PUNCTUATION AND SPACES 


Special delimiters are required іп F.l.s. See DELIMITERS later in this section for details on 
how they are used. 


Commas, Colons Separate fields. Their exact use 
апа Semicolons ,:; is shown with individual command descriptions. 
Quotation Marks “ “ Tell the system that the enclosed data is a string constant which 


may be a single character or numeral, a string of alpghanumerics, 
or a blank indicating a null string. 


Spaces Generally, spaces are ignored. Occasionally, however, they must 
be used as delimiters; for example, the system will return an 
error message if a SAVE command is written like this: 


5 


5АУЕ%;100,500 


Тһе syntax form of each command shows when spaces аге 
required. 


The system has interpreted the E in E$ as part of the keyword 
SAVE. The command must be written with a space, like this: 


SAV E$;100,500 
Trailing Dots ... If a syntax or descriptive form is followed by trailing dots, the 
preceding field may be repeated as many times as desired. 
NOTE 


See SYNTAX in the 4050 Series Graphic System Reference Manual for 
further details. . 


e 


4907 & EXTENDED MEMORY OPERATOR'S REV, OCT 1982 4-5 


HOW ТО WRITE A COMMAND 


( 


HOW ТО WRITE А FILE IDENTIFIER 


STORAGE STRUCTURE (Section 3) describes libraries and files. This section explains 
how to use а File Identifier, abbreviated F.I., to create and access those libraries and files. 


Whether the F.I. is used to create a new file or locate an existing file depends on the 
command in which it is placed. The F.I. is useless by itself. It (or a logical file number (Мп) 
representing the Е.І.) must go inside a command. 


Lo Е 


Every file has its own F.I.. No two files have exactly the same F.I. unless they are on 
different discs. 


What is a File Identifier? 


A file identifier is the name of a file in a format the File Manager can understand. The 
syntax form of this format is as follows: 


LE.— ee d 


[€][E[E library пате/ШІ {file name] [extension] [:password] 


` 


NOTE 


C 


D. O т. 


The Extended Memory File Manager strips the ‘а’ character off all File 
Identifiers and ignores it. No "USERLIB" or "SYSLIB" exist, and the “$” 
character is illegal. 


Field Descriptions 
@ (The Commercial "at" Sign) 


The “@” is used to circumvent the "current library." By using the @ the system will 
access any library entered. See USERLIB String Suppression in this section and the 
CALL "USERLIB" command description in Section 5. 


library name 


The entry here specifies the name of the library and must be from one to ten 
characters long. The first character must be alphabetic, the remaining characters 
can be either alphabetic or numeric. For convenience, first level libraries fall into 
groups named SYSLIB, USERLIB, or SCRATCHLIB. Each group is accessed 
differently. See USE OF 1ST LEVEL LIBRARIES in this section. 


i; уз безе 


Не пате 


Тһе entry here specifies the name of the file and must be from one to ten characters 
long. The first character must be alphabetic; the remaining characters must be either 
alphabetic or numeric. 


C 


С. G 
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Extensions 


The extension allows the program to distinguish between similar, but not identical, files 
by acting as a label or tag on the end of the name of the file. 


EXAMPLE: 
File: VEG 
Files with extensions: VEG.PER or VEG.ANN 
An extension may be specified for any file, but an extension is never assigned to a library. 


The extension may be 1 to 4 characters long. The first character must be alphabetic, the 
rest alphanumeric. 


The sample storage structure in Figure 4-1 and the description following it show how 
extensions are used: 


1st level 

2nd level 

3rd level 

SUPPLIES 4th level 

5th level 

2380-28 
Figure 4-1. Sample Storage Structure (5 Levels, 6 Files). 
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This structure shown in Figure 4-1 includes files WILLCALL, SUPPLIES, TOOLS, TOOLS, 
VEG.PER and VEG.ANN. All the other entries are libraries. Since there are six files in this 
structure, six F.l.'s were required to construct it. Notice the extensions “PE” and “ANN” 
were added onto the “VEG” files. This is to allow the Graphic System to distingush 
between them. You may have noticed that no extensions were specified for the files 
named “TOOLS”. This is because they are under different libraries. Once the Graphic 
System reaches either “HARDWARE” or “GARDEN” in its search for a "TOOLS" file it is 
unaware that there is another "TOOLS" file anywhere else. As a result, no extensions are 
necessary. 


Passwords 
Passwords may be assigned to any library or file to prevent unauthorized access. When 
attempts are made to access the file, the password or passwords must be entered in the 
F.I. with the file and library names, or access will be prevented or restricted.? 

NOTE 


Be sure to write down passwords when they are assigned. 


Passwords are specified in F.I.’s along with library names, file names and extensions. The 
password must immediately follow the name of the library or the name of the file, and 
must be separated by a colon (:). The format is shown below: 


library or file name:password 


А password may be 1 to 10 characters long. The first character must be alphabetic, the 
rest alphanumeric. 


Assume that а new file name “SALARIED” along with the password “BOSS” is to be 
created іп an existing storage structure under a 1st level library “PERSONNEL.” The F.I. 
in the CREATE command must be written this way: 


‘““@PERSONNEL/SALARIED:BOSS” 


Suppose the existing storage structure looks like Figure 4-2. 


2unless a master password is used. See CALL “FORMAT” command description in Section 5. 
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НОУ/ ТО МЕТЕ А СОММАМО 


PERSONNEL 
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Figure 4-2. Sample Storage Structure (2 Levels, 1 File). 


А CREATE command with this F.I. results in the revised storage structure shown in Figure 
4-3. 


PERSONNEL 


SALARIED:BOSS 


2380-26 


Figure 4-3. Sample Storage Structure (2 Levels, 2 Files, 1 With Password) 


Remember that: 


® A password cannot be assigned to the “PERSONNEL” library because it existed 
before this new F.I. was written. 


* A file name password сап be changed by executing a CALL “RENAME” command 
if the original password is specified in the command. Library passwords cannot be 
changed. 
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NOTE 


When separate discs are dedicated to an individual user or subject the F.l.s 
can be very simple. This is because fewer storage levels are necessary. 


For example: 

To access a file on a disc with two libraries (ignoring the standard first 
level library (see "Use of 1st Level Libraries", later in this section)), each 
containing two files, requires an Е.І. like this: 


"library/file" 


Accessing a file on a disc exclusively devoted to files requires an F.I. like 
this: 


"file" 
By dedicating a disc to a particular user and his own program, the disc can 
always remain in his possession. This means passwords may be 
eliminated altogether. 


Use of 1st Level Libraries 


There are three types of 1st level libraries: 


SYSTEM LIBRARY USER LIBRARY SCRATCH LIBRARY 
(SYSLIB) (USERLIB) (SCRATCHLIB) 
SYSLIB: This library contains programs for system control, such as data 


acquisition. It also may be used for commonly accessed public 
programs for math or statistics work. There is only one system 
library, but it can be as large as an entire disc. 


USERLIB: These libraries contain files usually restricted to a particular user, 
public files for a variety of users, or a combination of the two. There 
is no limit to the number of user libraries a user may create, and 
each may be as large as an entire disc. Every user library created 
must have a different name. For example: MYLIBRY, DOG, etc. 


SCRATCHLIB: This library contains information, sample programs, etc. This is the 
default library. Unless directed otherwise, the system will always 
access this library for file creation or selection. There is only one 
scratch library but it may be as large as an entire disc. 
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SYSLIB: Enter the $ followed by the rest of the libraries and file names. 
Example: “ФА/В/С” (which is the same as "SYSLIB/A/B/C"). This 


П Each type of 1st level library may бе addressed as shown below: 
will suppress the current library. 


USERLIB: Enter “@” then the name of the user library then the rest of the 
library and filenames. 


П Example: “@MYLIBRY/A/B/C” will suppress the current library and 
let the system access MYLIBRY . 


Л SCRATCHLIB: Leave out the name of the 1st level library, SCRATCHLIB, then 
enter the rest of the library and filenames. 


Example: “A/B/C”. 


ха a 


The system will always default to the scratch library if there is no 
other current library. If there is a current library, it must be 
suppressed this way: 


па 
2 


“@SCRATCHLIB/A/B/C” 


NOTE 


It is important to remember that these groups are for convenience only. 
Any or all data may be placed in any one of the above categories. 


Examples 


The following examples illustrate how to write F.l.'s for creating or locating files in 
SYSLIB, USERLIB and SCRATCHLIB storage structures ("storage structure" means all 
libraries and files under these 1st level libraries). To see how characters are used as 
delimiters іп F.I. construction, see DELIMITERS in this section. 


SYSLIB 


Examples 1 through З show how F.I.’s should be written for the "SYSLIB" storage 
structure (Figure 4-4). These Ғ.1.5 circumvent any current library. This means the system 
f \ will not look in the current library for the file. 


Шз ol I — Ше, 
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59 — | 


БЕГЕН 
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Figure 4-4. Sample Storage Structure (5 Levels, 7 Files). 


"SPET/DOG/HUNTING/LAB" 


м 
i 
Example 1: | 
L 


This example locates SYSLIB (by using the $) then libraries "PET," "DOG" and 
“HUNTING” in succession. The file "LAB" is accessed last. 


Example 2: i 
“$ЕООР” | | 


This example locates the file “FOOD” т "SYSLIB." 
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П ДА 
П Ехатр!е 3: 
А$ 
Л 
! 
n If the statement 
A$ = "SFOOD" 
П is executed previously, the same file as п example 2 will be located if A$ is entered in the 


F.I. field. Although this file is on the 2nd level, it has no subsequent files and is, therefore, 
a “lowest level” file. 


222 


USERLIB 


The following examples show how Е.1.'5 should be written for the “MYLIBRY” storage 
structure in Figure 4-5. 


A © 


MYLIBRY 


| FIRE HEALTH FEDERAL STATE 
| INCOME | EXCISE | INCOME.PERS | PROPERTY INCOME.CORP 


2380-23 


Figure 4-5. Sample Storage Structure (4 Levels, 7 Files). 


Examples 4 and 5 show how Е.1.'$ are written to circumvent the current library. Examples 
ж 6 апа 7 show how to write Ғ.1/5 when "MYLIBRY" is the current library. 


шз I 3 Шз — —3 —)J шз аа 21 шз —3J 
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Example 4: 
“@MYLIBRY/TAXES/FEDERAL/EXCISE” 


This example specifies the file “EXCISE” in libraries “MYLIBRY,” "TAXES," and 
“FEDERAL.” The @ is necessary to circumvent the current library. 


Example 5: 

“© MYLIBRY/TAXES/STATE/INCOME.CORP" 
This example specifies the file "INCOME" (with the extension ".CORP") located in 
libraries *MYLIBRY," "TAXES," and “STATE.” Тһе @ is necessary to circumvent the 
current library. 


Example 6: 


CALL "USERLIB", “@ MYLIBRY" 
"INSURANCE/FIRE" 


This example specifies the 2nd level library “INSURANCE” in "MYLIBRY"; then searches 
for the file "FIRE." No 1st level entry is necessary because MYLIBRY was specified in the 
CALL "USERLIB" command as the current library. 
Example 7: 
C$ 

If the statement 

C$ = “INSURANCE/FIRE” 
is executed earlier, C$ will select the same file as Example 6 when entered into the F.I. 
field in the command. 


SCRATCHLIB 


The following examples show how ап F.I. must be written for the sample scratch library in 
Figure 4-6. 
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Figure 4-6. Sample Storage Structure (4 Levels, 5 Files). 


— 
m 


Example 8 shows how an F.l. must be written to access a file in SCRATCHLIB (the default 
library). 


Example 9 shows how to write ап F.I. to SCRATCHLIB when there is a current library. 
Example 8: 
“DATA/VOLT/V250” 


This example locates file “У250” in libraries "DATA" and “VOLT” in the current default 
library “SCRATCHLIB.” 


Example 9: 
“@SCRATCHLIB/DATA/AMP/V1 25” 
In this example, the first entry (@ SCRATCHLIB) circumvents the current library and 


sends the system to the scratch library. The file “V125” is then located. This example 
shows how to locate the scratch library when it is not the current library. 


> 


>>] 
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Delimiters | | 

The slash (/) is used to separate name fields. 

EXAMPLE: = 
GMYLIBRY/A/B/C/D и 

The colon (:) is only used to separate а password from a library пате or file name. 

EXAMPLE: 


@MYLIBRY/A/B/C/D:PASS 


ст 


The period () is only used to separate an extension from the rest of the Ше name. 


EXAMPLE: 


ЄС 


@MYLIBRY/A/B/C/D:PASS.EXT 


OR 


c 


Cc t 


@MYLIBRY/A/B/C/D.EXT 
Quotation marks (47) are used to enclose the entire F.I. 


EXAMPLE: 


С 


“@ MYLIBRY/A/B/C/D.EXT" 


C 


No spaces may be included in Е.1.'$. 


No delimiters can be used in an F.I. except those specified here. 


Е 


Special Characters #, *, 2,(0,% 


с 


The special characters аге the pound sign (5), the asterisk (*), the question mark (2), the 
commercial "at" sign (@), and the dollar sign ($). | | 
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Special or Multiple File Selection (#)(*)(?) 
The following commands can be written to locate more than just a single file: OPEN, 
DIRECTORY, KILL, COPY ... TO, CALL “RENAME,” CALL “FILE”. By using special 
characters you can write commands that will find: 

® All files on all levels below any 1st level library. 


® All files on any single level. 


® All files with common names, common prefixes or common extensions on any 
single level. 


The files involved will be chosen in the order they are listed in the directory. Only 
“eligible” files will be selected, and files are eligible only if: 


® Passwords are entered completely and correctly. 
€ Device or disc is not write protected. 
€ The MOUNT command has been executed. 


Pound Sign (#) 


The pound sign selects all eligible libraries and files at the level the character is entered 
as well as all libraries and files at subsequent levels. 


Limitations: 

® Only one “%” may be used in апу Е.1. 

e Slash marks (/) cannot be used immediately adjacent to a ' X". 

€ Only one file level (with an optional extension) may be specified to the right of a “3%”, 
EXAMPLES 
These examples show the use of the “#” in an Е.І. 
Assume “MYLIBRY” is the current library. 

Example 1: 

og 


This example locates all files under “MYLIBRY” as shown in Figure 4-7. 
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“/ 
> 
1st level 
ШЕСІ 2nd, 3rd, 4th, 5th levels 
2380-27 
Figure 4-7. Sample Storage Structure (2 Levels). 
Example 2: 


"A3?" 


This example locates all files on the 3rd, 4th and 5th levels in library "A" as shown in 


Figure 4-8. | 
WY 


MYLIBRY 


1st level 


2nd level 


LIBRARY A 


3rd, 4th, 5th levels 
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Figure 4-8. Sample Storage Structure (3 Levels). 


U 
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Example 3: 
“А/В” 


This example locates а! files on the 4th and 5th levels below library “В” as shown іп 


Figure 4-9. 

MYLIBRY 1st level 

LIBRARY A 2nd level 

LIBRARY B 3rd level 

4th, 5th levels 
2380-29 
Figure 4-9. Sample Storage Structure (4 Levels). 

Example 4: 


“A/B/C #” 


This example locates all files on the 5th level below libraries “А”, “В”, and “С” as shown 
in Figure 4-10. 
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1st level 
2nd level 
3rd level 
4th level 
5th level 
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Figure 4-10. Sample Storage Structure (5 Levels). 


Example 5: 
“А/В #.BLUE’ 


This example locates all files under library “В” with the extension “BLUE”. All other files 
in the storage structure with the extension “BLUE” will be ignored. 


V 
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poe 


MYLIBRY 1st level 
74 
1 MATH.BLUE LIBRARY A 2nd level 
1 
i LIBRARY B DATA.BLUE 3rd level 
1 RCH.BLUE CALC.BLUE LIBRARY C 4th level 
1 
| 5th level 


1 1 
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Figure 4-11. Sample Storage Structure (5 Levels). 
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Asterisk(*) 


ма 


The asterisk тау бе used three ways: 


А 1. То select all eligible libraries or files at the level or levels the character is 
3 entered. 
| 1 2 To select all eligible libraries or files with a particular prefix. 


3.  Toselect all files using extensions with a particular prefix. 


222 


Limitations: 


@ An asterisk locates only those libraries or files within a single level. All names 
on preceding and subsequent levels must be specified. If no subsequent names 
are specified, only files at the asterisk level will be selected. 


222 


2 


Ф Ап asterisk cannot be used to locate а file or library with а password. 


Шэ 


e Characters in a name cannot be used to the right of an asterisk; for example, "DO*" 
is legal but "D*N" is not. 
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Examples 1 through 4 show how to locate ail eligible libraries or files at the level the 
character is entered. Examples 5 through 7 show how to locate a file, library or extension 
with a particular prefix. Examples 5 through 7 are not whole F.I.’s but typical entries 
usable at any level. Assume that MYLIBRY is the current library for all these examples. 
Example 1: 


"*/B/C" 


This example locates all files named “С” in any 3rd level library named "B" which is in 
any 2nd level library in “MYLIBRY”. 


MYLIBRY 1st level 
LIBRARY X LIBRARY Y 2nd level 
LIBRARY A LIBRARY B LIBRARY A LIBRARY B 3rd level 


FILE C FILE F FILE D FILE E FILE C FILE G FILE H FILEC 4th level 


2380-32 


Figure 4-12. Sample Storage Structure (4 Levels, 8 Files). 


Example 2: 
“А/*/С” 


This example locates any Ше named “С” т any 3rd level library which is т 2nd level 
library "A" т “MYLIBRY” . 
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Example 3: 
“A/B/*” 


This example locates all 4th level files in the 3rd level library “В” which is in the 2nd level 
library “А.” 


Example 4: 
"A/B.*" 


This example locates all 3rd level files "B" with any extension in 2nd level library "A." The 
arrows in Figure 4-13 show these files. 


MYLIBRY 1st level 
LIBRARY A LIBRARY X 2nd level 
Зга level 


Figure 4-13. Sample Storage Structure (3 Levels, 7 Files). 


Example 5: 
A* 
This example locates any library or a single file with the first letter of "A" such as these: 
AB 


A1 
AABCO 
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Example 6: 
A*.RED 


This example locates any file with the first letter “А” and the extension “НЕР”. Remember 
that extensions cannot be assigned to library names. 


Example 7: 
JUMP* 
This example locates any library or file with the prefix “JUMP” such as these: 
JUMPING 
JUMP 
JUMPY 


Question Mark (7?) 


The question mark may be used to replace single characters when specifying library 
names, file names or extensions. 


Limitation: 
The question mark cannot represent more than a single character. 


The following examples are not complete F.I.’s but typical entries using the “2” which may 
be employed at any level. SCRATCHLIB is the current library. 


Example 1: 


This example locates any library or file with a name one character in length. 
Example 2: 
2222? 


This example locates апу library or file name опе, two, three or four characters іп length. 
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This example locates all library names on one level which are one, two, or three 
characters long with any file on the next level with a name one, two, or three characters 


long. 


Example 4: 


CA?/CO? 


This example locates all library or file names оп one level with two or three characters 
beginning with “CA” with any file name on the next level with two or three characters 


beginning with “СО. 


The example will locate: 


This example will not locate: 
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CA/CO 
CA/COW 
CAT/CO 
CAB/COT 
CAT/COW 
CAR/CON 
CAP/COB 


CATT/COWE 
CATT/COW 
CAT/COWE 
CAB/KING 
CA/COWE 
CATT/CO 
С/С 

C/COW 
CAT/C 
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USERLIB String Suppression (@) 
When a string representing the first field of an F.l. is entered with a CALL "USERLIB" 
command, that portion is accessed and automatically placed in front of any Е. in 
subsequent commands. This portion is called the current library, and its purpose is to 
reduce the amount of work and space in accessing files in subsequent commands. 
However, it is not always desirable to access a file in the current library. To circumvent 
the current library, a commercial "at" sign (8) must precede the F.I. By using the “@,” the 
system will access any other library named in the F.I. 
EXAMPLES: 

100 CALL "USERLIB","YOURLIBRY" 

250 OPEN “@ MYLIBRY/A/B';S,"F"', AS 

300 OPEN “L/M”;2,“F”,B$ 
When line 100 is executed, “YOURLIBRY” is specified as the current library. 
When line 250 is executed, the system accesses “MYLIBRY” because of the “@” in the 
F.l. and ignores the current library, “YOURLIBRY”. This does not change the current 


library. 


When line 300 is executed, the system automatically accesses the current library, 
“YOURLIBRY,” and locates 2nd level library “L” and 3rd level file “М.” 


Remember: 


€ The “©” must be used to access a user library UNLESS that library is the current 
library. 


€ The current library defaults to SCRATCHLIB. 


e The “©” also сап be used to create or access а 1st level file in the same way it 
creates or accesses a library. 
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Simplified SYSLIB Access ($) 
There are three ways to access SYSLIB (system library): 


1. Enter SYSLIB into a CALL “USERLIB” command. This makes "SYSLIB" the current 
library. The $ should not be used in a CALL “USERLIB” command. 


2. Enter an “@” as the first character іп an F.I. followed by “SYSLIB” and the balance 
of the F.I. 


3. Enter a “$” (which reads "SYSLIB" to the Graphic System as the first character 
іп an F.I. followed by the balance of the F.I. No slash mark (/) is necessary after 


entering the $. 


When method 2 or 3 is employed, the current library is ignored. 
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Section 5 


COMMAND DESCRIPTIONS 


INTRODUCTION 


This section explains how to read command descriptions. Each command is then 
discussed in detail. 


HOW TO READ COMMAND DESCRIPTIONS 


The File Manager commands are arranged alphabetically in this section (the word 
“CALL” )is disregarded). 


COMMAND FORMAT 


The individual commands are divided into the following parts: 


Purpose 

Syntax Form 
Descriptive Form 
Field Definitions 
General Information 
Prerequisites 
Examples 


Occasionally, extra information will be added to a command description to help a user 
with its execution or application: For example, whenever a command is applicable only to 
a specific configuration or operates differently with the Extended Memory File Manager, 
this information will be included in the command description. 


Purpose 


This section explains the function of the command. 


Syntax Form 


The syntax form shows the abbreviated form of the keyword, and the number of fields, 
delimiters and punctuation required. Remember, quotation marks are required for all 
strings and string constants. See the examples in the command descriptions. 
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The syntax form also shows either the exact entry or class of entry required (constant, 
string constant, numeric expression, numeric variable, string, string variable, target string 
variable, target numeric variable). Although a file identifier may be represented as a string 
or string variable, it is always shown in the syntax form as F.I.. For more details see HOW 
TO WRITE A COMMAND (Section 4). 


Brackets [ ] indicate that the field is optional. Nested brackets [A[B]] indicate that while 
both fields are optional, the outside field (A) has priority and any entry must be made 
there first. 


Braces || indicate that the field is required. You must choose between the terms, 
characters, classes or numbers within the braces. 


Descriptive Form 


This form shows the complete keyword, followed by a one or two-word definition of each 
field. 


Field Definitions 


This section gives a complete description of each of the fields shown in DESCRIPTIVE 
FORM. 


General Information 


Operational details of the command are described in this section. 


Prerequisites 


This section lists operations or commands that must be executed before executing the 
command being discussed. It may also describe the condition that must exist before 
execution of the command. 


Examples 


This section shows examples of the command. In most cases a sample line number 
precedes the command. Some examples represent field contents with X’s or N’s. The use 
of commands in programs is demonstrated in INPUT and READ command descriptions as 
well as SAMPLE PROGRAMS, USING PRINT AND INPUT IN A PROGRAM, and USING 
WRITE AND READ IN A PROGRAM in the appendices. 


NOTE 


Line numbers, though not always shown, can precede all commands 
described in this manual. 
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APPEND 


^N 


APPEND See Appendix E for information on using 
| this command with the Extended Memory 
Purpose File Manager. 
П The APPEND command brings a program from a specified file on the disc and places it: 
" a. Prior to the program already in memory or 
і b. Within the body of the program already іп memory ог 


с. Subsequent to a program already in memory. 


n SYNTAX FORM 
! 


APP F.I. [, string] ; constant, constant 


DESCRIPTIVE FORM 


APPEND F.I. [,“ASCII”] ; target line number, increment between line numbers 


Command Field Definitions (Descriptive Form) 


APPEND This is the keyword for this statement. Only three 
characters, APP, are required. 


РІ. This entry must match the Р.І. already assigned this 
file or indicate the location of the F.I. with a string 
variable. If the Р.І. is entered, it must be in quotes: 
for example, “@MYLIBRY/DOG”. 


пиз 11. 1 а 


“ASCII” “ASCII” or a string variable may be entered here. An 
“ASCII” entry implies that ASCII data is to be 
retrieved. If a string variable is used, it may 
represent “ ", implying binary data, or “ASCII”, 
implying ASCII data. This way a A$ entry, for 
example, allows the same command to be used 
repeatedly to retrieve both kinds of data. 


If “ASCII” is entered, it must be in quotes: “ ”. If no 


fN entry is made, the system defaults to a binary 
append. 


4907 & EXTENDED MEMORY OPERATOR'S REV, OCT 1982 5-3 


2: I4 3. шд 


COMMAND DESCRIPTIONS 


APPEND 


target line number This entry provides the line number of the current 
program to which the file program will be sent. The 
entry must be an integer of 1 to 65535. 

increment between line numbers This entry specifies the increment between line 


numbers. The entry must be an integer of 1 to 
65535. If no entry is made in this field, the 
increment defaults to 10. See Graphic System 
Reference Manual for details. 


General Information 

The appended program is inserted into the current program at the target line number. The 
first statement transmitted from the file program REPLACES the statement already 
appearing on the target line number. Line numbers in the current program greater than 
the target line number will be placed after the appended program. Any line numbers 
following the target line number will be renumbered. 


This command is executed on a file in the current device. See UNIT command description. 


Prerequisites 


Disc must be mounted but device must not be reserved. File does not have to be OPEN. 


Examples 
Example 1: 
100 APPEND “@ MATH.OBJ”;210,5 
This example appends a program with an F.I. of " MATH.OBJ" to the current program 
in memory starting with line number 210. The combined program is renumbered in 
increments of 5 from line 210 up. 
Example 2: 


120 APPEND “© ARCH:J1500.0BJ",110,5 


This example appends a program with an F.I. of " ARCH:J1500.OBJ." The target line 
number is 110 and the increment is 5. 
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Example 3: 


=I 


135 APPEND “$FUNNY.PGM”;250 


= 


This example appends the program in “FUNNY.PGM” located in SYSLIB. The target 
line number is 250. 


раю 


Ехатріе 4: 


140 АРРЕМО В$;3500 


да 


This example appends any program that has its Е.І. located іп В$. The target line 
number is 3500. 


25-222 
J 
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ASSIGN 


ASSIGN 


Purpose 


See Appendix E for information on using 


this command with the Extended Memory 
File Manager. 


The ASSIGN command lets you make changes to the file attributes that were originally 
assigned in the CREATE command. 


SYNTAX FORM 


ASS "F.I."; string 


DESCRIPTIVE FORM 


ASSIGN "F.I."; attributes 


Field Definitions (Descriptive Form) 


ASSIGN 


Р.І. 


attributes 


This is the keyword for the command. The entry may be made as 
shown in syntax form. 


The entries in this field must match the F.I. currently assigned to 
this file. An F.l. must be in quotes. 


Except for the BINARY or ASCII designations, any current file 
attributes may be changed by entering one or more of the 
following characters in this field. 


R(private) 

U(public) 
S(scattered) 
C(contiguous) 
N(not compressible) 
M(compressible) 


S can be changed to C only if the data entered so far is 
contiguous. 

Conflicting entries such as R and U will result in the last, or 
“right-most’, character being accepted. See CREATE command 
description. 

An attribute must be in quotes: “В”. 
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General Information 


Generally, this command is executed from the keyboard rather than as part of a program. 


2-2 


This command is always executed on а file in the current device. Зее UNIT command 
description. 


222 


Prerequisites 


ыа 


Device must ре mounted but not reserved. 


an 


Examples 


222 


Example 1: 


LI 


ASSIGN“ @НМАМСЕ/СМТВУВМК.ОВ/”; “В” 


This command changes the “CNTRYBNK.OBU” file т “FINANCE” to a private status. 


2 


Example 2: 
ASSIGN'"SMATH.OBJ";"RSN" 


This command changes the “МАТН.ОВЈ” file in the SYSLIB to a private, scattered 
and non-compressible status. 


елегі ша 


Example 3: 


pas 


ASSIGN“$MATH.OBJ”; A$ 


This command carries out the same function as example 2 if A$ = “RSN.” 


а-а — 


у 


- 
ed 
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CLOSE | | 
) | - 

МЈ. 

CLOSE | 
Ригрозе | | 


Тһе CLOSE command is used to close all open files or to close a specific file. 


SYNTAX FORM | | 

зм 
CLO [constant] 

|] 
DESCRIPTIVE FORM 

Ц 
CLOSE [п] | 


Field Definitions (Descriptive Form) tid 
\ 


CLOSE This is the keyword for this command. Only three characters, or CLO, are 


required. | | 
— 

lfn Logical file number: The entry in this field specifies the particular file to be 
closed. This number, always an integer from 1 to 9, must match the logical | | 


Ше number assigned іп the OPEN statement. When по number is assigned, 
all files in the Graphic System internal tape unit and the external disc | 
devices are closed. | 


General Information L 


See FILE POINTER OPERATION (Appendix C), which shows where the logical pointer is | 
located after a file is closed. This is significant when the file is reopened for another read, || 
write or update operation. 


This command is always executed on files in the current device. See UNIT command 
description. Н the file specified in the command is not open, the CLOSE command is 


ignored. y 


OLD, END, INIT or DELETE ALL commands close all open files. Pressing the BREAK key 
twice also closes all open files but aborts program control of files. МЛ 
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1 CLOSE 
4 a 
П Prerequisites 
П Мопе. 
f 
i 
1 Examples 
! 
Ехатріе 1: 
П 1100 CLOSE 7 
П This example closes а file that has been assigned logical file number 7. 
Example 2: 
1 1005 CLOSE 
n This example closes all files on both the internal tape drive and all external disc 
devices. 
n 
1 If a SEQUENTIAL file is opened for full access (Е), те pointer is moved 
' to the beginning of the file. If по reading or writing is carried out and те 
file is closed, the pointer remains at that point. This means that all data 
1 past that point is lost. This does not apply if files аге closed with INIT ог 
DELALL. If you have opened a sequential file for full access, you must 
READ or INPUT from the file (for example, store strings repeatedly into 
1 the same string variable) until the End Of File is reached. This moves те 
pointer to the end of the data, and the file can be closed without loss of 
1 data. 
To erase the contents of a sequential file, use OPEN, then CLOSE, then 
1 ОРЕМ. 
1 
t 
1 
' 
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COMMAND DESCRIPTIONS 
CALL “COMPRS” 


CALL *COMPRS" (Compress) 


See Appendix E for information on using 
this command with the Extended Memory 


Purpose File Manager. 


The CALL “COMPRS” command collects unused spaces on a disc into one contiguous 
space. You have the option of reducing existing file space on each file to exactly fit stored 
data or programs. This makes more space available for new files. 


SYNTAX FORM 


CAL “COMPRS”, numeric expression, numeric expression 


DESCRIPTIVE FORM 


CALL “СОМРН5»”, device address, compress control 


Field Definitions (Descriptive Form) 


CALL "COMPRS" These are the keywords for this command. Entry may be made 
as shown in SYNTAX FORM. 


device address The device address may be seen on or near the front of the 
device. 
compress control When 1 is entered, the system collects and groups all space not 


already occupied by data or programs regardless of whether or 
not that space is formatted as file space. When 0 is entered, the 
system collects and groups only that space not occupied by 
files. 


General Information 


While CALL “СОМРВ5” is quite useful, it cannot collect all the free space on the disc. It 
also may cause the system to run slower on files that have been expanded after being 
compressed. To collect and group 100% of the free space, a CALL “DUP” command must 
be executed. 
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CALL “COMPRS” 


2 


Ап unmarked bad block тау be encountered during a COMPRESS execution. This results 
in a device I/O error. There is no way to tell which file contains the bad block unless each 
file is read. When the bad block in the file is encountered, an error message containing 
the bad block address is displayed. This address must be entered in a CALL "MRKBBG" 
command. After this command has been executed, CALL “СОМРН5” may be issued. 


If the bad block is contained in the directory, a CALL "DUP" command is necessary for 
information recovery. The duplicated disc information will be missing one or more library 
structures corresponding to the extent of damage or wear in the directory. If the available 
system contains only a single drive, the disc cannot be read and must be discarded. 


Prerequisite 


2222 


Device must be reserved. 


2—2 


Ехатр!е$ 


Example 1: 


- 


BR | 
2 


110 CALL "COMPRS",B2,A1 


pes 


The address of the device is in B2. First, the system checks the address; then it 
finds the device. If 1 has been previously entered in A1, this example collects and 
groups all space inside and outside files. 


ча 


Ехатр!е 2: 


222 


140 CALL "COMPRS",2,0 


2 


This example, with actual values іп the last two fields, locates the device with the 
address of 2 and then collects and groups all space not occupied by files (as 
specified by 0). 
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COPY. 


5- 12 


.. ТО 
СОРЕ ето See Appendix Е for information on using 
this command with the Extended Memory 
Purpose File Manager. 


The COPY ... TO command will copy one or more files named in an Ғ.І. from one device to 
another or to a different location on the same disc. All attributes, as well as passwords 
and extensions, are also duplicated. Changes to names of files, passwords and 
extensions may also be made using this command. 


SYNTAX FORM 


COP "F.I.", numeric expression TO “Е.1.”, numeric expression 


DESCRIPTIVE FORM 


COPY “F.I.” (source), source device address TO “F.I.” (target), target device address 


Field Definitions (Descriptive Form) 


COPY... TO These are the keywords for this command. 
They may be entered as shown in SYNTAX 
FORM. 

РА. (source) The F.I. source entry is the Е.І. of the file to 


be copied. If more than one file is to be 
duplicated or if F.l. changes are desired, see 
MULTIPLE FILE TRANSFERS or CHANGING 
NAMES in this command description. 


An Е.Е must be in quotes. 


source device address This is the address of the device that 
contains the files. This address is shown on 
or near the front of the device. 
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COPY...TO 


2 


РА. (target) The F.I. target entry defines where the file is 
to be copied and the name assigned to the 
copied file. Remember, two files with the 
same F.I. cannot be duplicated on the same 
disc. 


AJ 


— 


An F.I. must be in quotes. 


target device address This is the address of the device that is to 
receive the information. The address is 
shown on or near the front of the device. 


— —— с 
& 


General Information 


шз 3 


Duplication will not occur И: 


© F.i. target already exists on the second device. 

@ The source ЕІ. is a library. 

€ The source device or target device is reserved or write-protected. 
® The disc is not mounted or is incorrectly mounted. 

€ The second device contains bad blocks. 

€ Specified passwords are not used. 

€ More than 8 files are open. 


52221 
2 


а 
-— 


2222 


This command is also used to copy files Нот one area to another оп the same disc. 


ша 


Libraries are created іп the new location if none exist. 


2 


No files are erased. 


Prerequisites 


222 


Discs must be mounted but the device must not be reserved. Files must ре closed. 


ша 


Examples 


Il 


Example 1: 


а 


110 COPY"SDOG/CAT'",2TO" eMYLIBRY/DOG/CAT",1 


Assume SCRATCHLIB is the current library. 
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COPY. 


.. TO 


This example accesses SYSLIB on device 2 and copies file “САТ” in library “DOG” 
to MYLIBRY in device 1. 


Example 2: 
125 COPYAS,ATOBS,B 


This example functions exactly as Example 1, if the F.I. and device address have 
previously been entered into the variables shown: 


А$ = "SDOG/CAT" 
А=2 


В$ = “@MYLIBRY/DOG/CAT” 


Example 3: 
450 COPY“FRED/TOM’”,1TO“ @ YOURLIB/FRED/TOM",2 


This example presumes that a CALL “USERLIB” has been executed specifying the 
1st level library in the source F.I.. 


Library "FRED" and file “ТОМ” in device 1 are copied to YOURLIB in device 2. 
Example 4: 

150 COPY"FRED/TOM',1TO" € YOURLIB #”,2 
This example functions like Example 3. The only difference is in the construction of 
the target F.I.. A pound sign (%) has been used to indicate that everything being 


transmitted, including the F.I., should be duplicated as it is. No slash (/) is necessary 
between the 1st level library (YOURLIB) and the “#.” 


Multiple File Transfers. Using ' €", “*” or the "?" (see SPECIAL CHARACTERS іп 
Section 4) in the ЕІ. construction allows selection and duplication of specific groups of 
files. The following examples illustrate how these characters may be used. Those libraries 
and files with passwords are ignored unless the password is part of the Е.1. 


Assume "MYLIBRY'' is the current library. 
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COMMAND DESCRIPTIONS 
COPY...TO 


The Pound Sign (#) 


Example 1: 


120 COPY “%”1Т04%”,2 


а 


This example duplicates everything in “MYLIBRY” on device 1 to “MYLIBRY” on 
device 2. This statement would not be carried out if both device addresses were 
identical. 


з 


Ехатр!е 2: 


be 


180 COPY"DOG X" 1TO" #’,2 


J 


This example duplicates everything in the 2nd level library "DOG" in "MYLIBRY" on 
device 1 to "MYLIBRY" on device 2. 


--- 
—- 


шз 


Ехатр!е 3: 
460 COPY" @YOURLIB *X'",1TO' #’,0 
^W 


This example duplicates everything in YOURLIB on device 1 to "*MYLIB" on device 0. 


—3 


Example 4: 


180 COPY" X.CAT"1TO" #’,2 


This example duplicates all files with the extension “САТ” contained in “MYLIBRY” 
on device 1 to "MYLIBRY" on device 2. 


„а c 


The Asterisk (*) 


Bum 


Example 1: 
180 COPY"MATH/*/ALG",1TO" 4",2 
This example selects any file named “ALG” in any library in a library named 


"MATH." These files are located in "MYLIBRY" on device 1 and are duplicated in 
“MYLIBRY” on device 2. 


22222 22 


= 


--2 
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СОРУ... ТО 


Ехатріе 2: 
170 COPY“*/DOG/CAT/MOUSE”,1TO“ #’,2 


This example selects all 2nd level libraries with subsequent libraries of "DOG" and 
“CAT” with files of “MOUSE.” These are located in *MYLIBRY" on device 1 and аге 
duplicated on MYLIBRY on device 2. 


Example 3: 
285 COPY"FAST*/*/*" ATO" #’,2 


This example selects all 2nd level libraries with the prefix "FAST" and subsequent 
3rd and 4th level libraries and files. If a library with this prefix only contains files to 
the 3rd level or files that continue to the 5th level, no files will be selected. 


These libraries and files will be selected: 


FAST/RED/WHITE.YELL 
FASTLINE/RED/GREEN 
FASTLOOSE/YELLOW/BLUE 


These libraries and files will not be selected: 


FAST/RED/WHITE/YELLOW 
FAST/RED/WHITE:PASS 
GO/JIM/GREEN 
GOSOON/LIGHT/GOOD 


Files selected are duplicated from "MYLIBRY" on device 1 to "MYLIBRY" on device 2. 


Question Mark (?) 


5-16 


Example 1: 
170 COPY"GO?/TOM/FRED'TO" #2 


This example selects all 2nd level libraries with a two or three character prefix 
beginning with "GO". These libraries will be selected only if they contain a 
subsequent library of "TOM" and a file of "FRED". 
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These libraries and files will be selected: 


GO/TOM/FRED 
GOT/TOM/FRED 
GOB/TOM/FRED 
GOG/TOM/FRED.OBJ 


These libraries and files will not be selected: 


GOT/TOM/FRED/BOB 
GOD/TOM/FRED:PASS 
GOTT/TOM/FRED 


Libraries and files selected are duplicated from "MYLIBRY" on the current device to 
"MYLIBRY" on device 2. 


Example 2: 
210 COPY"??7?/*/*" 1TO" 9 YOURLIB #”,2 
This example selects all libraries with up to three character names with libraries in 
the 3rd level and files in the 4th level. They are duplicated to "YOURLIB" on device 
2. 
These files will be selected: 
TAD/OD/RATES 
D33/ZIP/NONE.OBJ 
DO/CONS/PROJ 


These files will not be selected: 


TAD/ALG/MATH/COMP 
GILD/TOM/FRED 
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СОРУ... ТО 


Changing Names. Name changing may be accomplished while duplicating single files, 
without the use of special characters. Examples 1 through 3 show how to change names 
when single files are duplicated. Name changing while duplicating multiple files, however, 
requires using ' XX", “*”, or the “?” (described in SPECIAL CHARACTERS IN FILE 
IDENTIFIERS in Section 4). These allow the user to change the names of libraries, files, 
passwords and extensions when transferring multiple files. Example 4 illustrates how 
these characters may be used. Assume "MYLIBRY' is the 1st level or current library. 

Example 1: 

120 СОРУ“@ YOURLIB/TOM",1TO"BOB",2 
This example selects the Ше “ТОМ” in "YOURLIB" on device 1. The file is 


duplicated as "BOB" on device 2 in "MYLIBRY." Remember, if "TOM" is a library, no 
duplication will take place. 


Example 2: 

130 COPY“ @YOURLIB/KEN/FRED:BEN”,1 TO"JANE/LORI:PAM",2 
This example selects the file “FRED” with the password “BEN” in library “KEN” in 
“YOURLIB” on device 1. The file is duplicated on device 2 in “MYLIBRY” as file 
“LORI” with the password “РАМ” under the new library “ЛАМЕ.” 
Example 3: 


275 СОРУ“А/В/С”,ЗТО“$М/М/О”,2 


This example selects the file “С” in libraries “MYLIBRY”, “А” and “В” on device 3. 
The libraries and file are duplicated on device 2 in SYSLIB as “М”, “М”, and “О.” 


Example 4: 
270 СОРҮ“$А #”,1ТО“В#”,2 


This example selects all files in library "A" т "SYSLIB" on device 1. These files are 
duplicated to "MYLIBRY" on device 2. The name of library "A" is changed to “В.” 
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COMMAND DESCRIPTIONS 
CREATE 


2 


ЕАТЕ 

сн See Appendix Е for information оп using 
this command with the Extended Memory 

Purpose File Manager. 


The CREATE command creates file space on the disc, and assigns the attributes and F.I., 
including passwords and extensions, if any. The last two fields in this command specify 
whether the file is to be random or sequential. 


SYNTAX FORM 


CRE “F.I.” [,"string"] ; numeric expression, numeric expression 


DESCRIPTIVE FORM 


CREATE “F.I.” [,"attributes"] ; number of logical records, record length 


wu ILLA а-а-а 


! ) Field Definitions (Descriptive Form) 


CREATE This is the keyword for this statement. Only three 
letters, CRE, are required. 


РІ. The entries іп this field must meet F.I. requirements. 
See HOW TO WRITE A FILE IDENTIFIER in Section 4. 


An F.I. must be in quotes. 


attributes If no entry is made here, the system defaults to the 
following conditions: 


B (BINARY): Only binary data may be entered. 


R (PRIVATE): Read operations may not be executed 
without using the password if a password has been 
specified. 


S (SCATTERED): Files will be located wherever there 
is space (on a single disc only). 


C^ 
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COMMAND DESCRIPTIONS 


CREATE 


number of logical records 


record length 


N (NOT COMPRESSIBLE): Files may not be com- 
pressed when file space exceeds current stored 
program or data. 


Any or all of the above conditions may be changed by 
entering one or more of the following attributes: 


A (ASCII): Only ASCII data may be entered. 


U (PUBLIC): Read operations may be executed without 
using a password in a OPEN “С” command. 


C (CONTIGUOUS): File can be stored only as a whole 
entity in a single location. 


M (COMPRESSIBLE): File may be compressed if in 
excess of current stored program or data. 


H (HOST BINARY): File can only be used to store 
binary programs. 


Any attribute entry must be in quotes: “М”. 


This entry specifies the number of records to be 
located within a random file, or, if the record length is 
zero, the length in bytes of a sequential file. To see 
how large your file must be, see FILE OR FILE 
RECORD SIZE REQUIREMENTS later in this descrip- 
tion. 


For the 4052/4054, this entry cannot be a variable 
standing alone; however, an expression is allowed. 


If file is to be random: 


This entry specifies the length of the records in bytes. 
These records are generally specified just long 
enough to contain the items or strings to be stored. 
See FILE OR FILE RECORD SIZE REQUIREMENTS at 
the end of this description. 


If file is to be sequential: 
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COMMAND DESCRIPTIONS 
CREATE 


Enter zero (0). The number entered in the previous 
field is then the length of the file. 


For the 4052/4054, this entry cannot be a variable 
standing alone; however, an expression is allowed. 


General Information 

The system automatically extends a file during WRITE, PRINT or SAVE operations if 
information exceeds allocated space. If the file has been designated C (contiguous) and 
there is an immediately adjacent file, an error message appears. Files cannot be extended 
over adjacent files in this way. If an error message appears, execute an ASSIGN 
command to change the attribute "C" to "S." 


This command is executed on a file in the current device. See UNIT command 
descriptions. 


File space is always extended in multiples of 256 bytes. 


Prerequisites 


Disc must be mounted but device not reserved. File must not already exist. 


Examples 
Example 1: 
100 CREATE "SMATH:RED.OBJ","U":100,128 
This command specifies that the file with the F.I. shown ($MATH:RED.OBJ) is to be 
public (U) which means it may be read without use of the password “RED.” It also 
specifies there are to be 100 records of 128 bytes each. The 128 indicates this is a 
random file. If the last entry were zero (0), the file would be a sequential file of 100 
bytes. 
Example 2: 
100 CREATE А%,“ОА”:100,128 
This statement specifies that the entire F.I. is stored in A$ and that the file is to be 


public (U) and ASCII (A). This means it may be input without use of the password (if 
any). It also specifies there are to be 100 records of 128 bytes each. 
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CREATE 


Example 3: 4051 4052/4054 

110 CREATE В%,С%;А,0 110 CREATE B$,C$;A+ 0,0 
This statement specifies that the F.I. is stored in B$ and that the attributes will be 
found in C$. The number of logical records normally is specified by the variable A, 
but because zero was placed in the record length file, the value of A will designate 
file length instead of number of records. This means this will be a sequential file. 
Example 4: 4051 4052/4054 

110 CREATE B$,C$;A,B 110 CREATE B$,C$;A+ 0,B+ 0 
This statement specifies that the F.I. is stored іп B$ and that the attributes will be 
found in C$. The numbers and length of logical records in the file is specified by the 
values of A and B, respectively. 
Example 5: 


140 CREATE“ @MYLIBRY/JACK”; 1000,0 


This statement creates a sequential file named “JACK” in “MYLIBRY” with default 
attributes and 1000 bytes in length. 


File or File Record Size Requirements 


The number of bytes allocated to a particular file or file record depends on whether you 
will be writing or printing information to that file. 


The table below shows how many bytes are required in PRINT and WRITE. 


ASCII (PRINT) 
Numeric values and 1 byte per character + 1 byte for Carriage Return 
strings 
BINARY (WRITE) 
Numeric Values 9 bytes for any value + 1 byte for EOR* 
Strings 4 bytes + 1 byte for each character + 1 byte for EOR* 


*EOR (End of Record Item) Used only for random access file. 
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Зее the Graphic System Reference Manual for additional information about multiple items 
ina PRINT statement and the PRINT ... USING statement. 


риб | 


Remember that the "dynamic allocation" feature extends file space as information is 
entered. Both sequential and random files are extended in blocks of 256 bytes. Individual! 
records in random files, however, cannot be extended in size. For this reason, it is 
important that you know the size requirements of the data you will be entering in random 
files before you create those files. 


NOTE 


ASCII random access files must be initialized. That is, each record in the 
files must be completely filled before the next record can be accessed. А 
quick routine to do this is shown on page B-2 of this manual. 


С 
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COMMAND DESCRIPTIONS 


CALL “CUSTAT” || 
- 
CALL *CUSTAT" (Controller Unit Status) || 
Ригрозе || 
| 
The CALL *CUSTAT" command generates status messages for all devices (disc drives) 
interfaced to the 4907 File Manager controller. This command does the same thing CALL | 
“DSTAT” does except it generates messages for all devices, rather than a specified || 
деуісе. 


E 


SYNTAX FORM 


г 


CAL “СУЗТАТ”, string variable 


DESCRIPTIVE FORM 


CALL “СУЗТАТ”, target string variable 


C 


Field Definitions (Descriptive Form) 


E.g 


CALL "CUSTAT" These are the keywords for the command. 
They may be entered as shown in SYNTAX 
FORM. 
target string variable This is where device status messages are | 


sent. Тһе target string variable must be 
dimensioned large enough to accommodate 
the messages. Each device status message 
is 186 characters. 


C 
Е. Е Fe 
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COMMAND DESCRIPTIONS 
CALL “СОЅТАТ” 


2 


General Information 


If the controller is designed to support more devices than are interfaced, the CALL 
“CUSTAT” command returns meaningless device status messages. 


Prerequisites 


Set clock. 


Example 
CALL “CUSTAT”, A$ 


This example generates device status messages for all devices and stores them in A$. 


ша ша 222.22 


5 


^^ 
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DELETE ALL || 


Purpose |! 


This command erases everything currently іп the Graphic System’s memory. 


—— 
— a 


This is a 4050 SERIES BASIC command. It is included here because it directly affects 


= 

4907 system operation. 
|| 
SYNTAX FORM | | 
iud 


DEL ALL 


I--— 


DESCRIPTIVE FORM 


DELETE ALL 


General Information 


In addition to erasing the Graphic System's memory, this command closes all disc files, 
sets the current device to zero (0), and specifies "SCRATCHLIB" as the current library. 


Prerequisites 


None. 


C E 


REV, OCT 1982 4907 & EXTENDED MEMORY OPERATOR'S || 


COMMAND DESCRIPTIONS 
DIRECTORY 


2 


DIRECTORY 


Purpose 


The DIRECTORY command generates file status messages which may be displayed on 
the Graphic System screen or stored on the Graphic System internal magnetic tape. If the 
Graphic System is equipped with Option 10, status messages may be output to the 
printer. 


SYNTAX FORM 


@N: 
DIR | 


633: 


DESCRIPTIVE FORM 


DIRECTORY [Luo address | [format code езі? ) 


о LI a ILE ша 


Field Definitions (Descriptive Form) 


DIRECTORY This is the keyword for this command. Only the first three 
characters, DIR, are necessary. 


МО address If no entry is placed in this field, the system displays the 
messages on the Graphic System screen. If the optional @ 33: is 
entered, the messages are stored on the Graphic System 
internal magnetic tape. In this event, a file must first be prepared 
to accept the information with the BASIC FIND and MARK 
commands. Each full file status message is 189 characters plus 
the characters in the Е.І. 

N represents the address of the printer if Option 10 is used. 


шз мша LJ 


B 


format code If there is no entry in this field or the entry is zero (0), the 
command returns a status message containing only the Е.І. 
(name) of the file or files specified in the last field of this 
command. The format code field cannot be left blank if an entry 
is made in the FI. field. 


AN 
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F.I. 


General Information 


This command is executed on a file in the current device. See UNIT command description. 


Prerequisites 


Disc must be mounted. 


Examples 


Entering 1 returns F.j.’s as well as relevant times and dates 
involving the file or files specified in the last field of this 
command. 


Entering 2 returns messages describing the “full file status.” 
This means that not only are the F.I.’s time and dates returned 
but also information regarding file space and attributes. 
For the 4052/4054, this entry cannot be a variable standing 
alone; however, an expression is allowed. 

110 DIRA2 will not work 

100 DIR А2+ 0 will work 


No passwords are returned when executing DIRECTORY. Fur- 
ther information about file status messages may be seen in 
DEVICE AND FILE STATUS MESSAGES (Appendix A). 


The system looks in this field for the F.I. of the file or files to бе 
selected for a status check. If no F.I. entry is found, the system 
assumes that a status check is desired for ALL files in the 
current library. 


Special characters may be used in this field if special or multiple 


file selection is desired. 


Any РІ. must be in quotes. 


Assume, for Examples 1-3, that SCRATCHLIB is the current library. 


Example 1: 


100 DIRO,“@ MYLIBRY #” 


This example generates status messages for all eligible files in "MYLIBRY." Since 
there is по I/O address entry, all messages are displayed on the Graphic System 
screen. The zero entry in the format code specifies that the status messages will 
contain only the F.I.’s of the selected files. 
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COMMAND DESCRIPTIONS 
DIRECTORY 


Example 2: 
100 FIND 10 
110 MARK 1,1000 
120 FIND 10 
130 DIRECTORY @33:2,“$STAT/TESTDESIGN” 
140 CLOSE 0 
This example locates the file "TESTDESIGN' in the library "STAT" іп SYSLIB. The 
file status is then checked and a “ІШІ status message” is stored on the Graphic 
System internal magnetic tape. The message is stored on file 10 on the tape which 
previously has been MARKed or dimensioned to 1000 bytes. 
Example 3: 
100 DIR 


Because there are no entries in the optional fields in this example, default conditions 
apply. The above command is equivalent to the command: 


100 DIRECTORY @ 32:0," 9 SCRATCHLIB zz" 


This example displays on the Graphic System screen “name only” file status 
messages for all files contained in SCRATCHLIB. 


Example 4: 
Assume for this example that MYLIBRY is the current library. 
100 DIR 


Because there are no entries in the optional fields in this example, default conditions 
apply. The above command actually appears like this to the system: 


100 DIRECTORY 9 32:0," € MYLIBRY #” 


This example displays on the Graphic System screen “name only” file status 
messages for all files contained in MYLIBRY. 


Example 5: 
100 DIRO,“@” 


This example displays on the Graphic System screen only the names of all the files 
on the current disc. 
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CALL “DISMOUNT” 


See Appendix E for information on using 
this command with the Extended Memory 


Purpose File Manager. 


The CALL “DISMOUNT” command notifies the system that a disc is to be removed from 
active use. After DISMOUNT execution, no OPEN statements may be executed on the 


disc. The term “DISMOUNT” does not mean that the disc is physically removed from the 
drive. 


SYNTAX FORM 


CAL “DISMOUNT”, numeric expression 


DESCRIPTIVE FORM 


CALL “DISMOUNT”, device address 


Field Definitions (Descriptive Form) 


CALL “DISMOUNT” These are the keywords for this statement. The entry may be 
made as shown in SYNTAX FORM. 


device address The device address may be seen on or near the front of the 
device. 


General Information 


АП files must be closed before a DISMOUNT command will take effect. If a file is open at 
the time of execution, the system waits until it is closed. File I/O, however, may continue. 
After a dismount, no files may be opened on that device until a CALL “MOUNT” command 
is executed. 
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COMMAND DESCRIPTIONS 
CALL “DISMOUNT” 
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Prerequisites 


Files must be closed. 


рио ша 


Examples 


ша 


Ехатр!е 1: 


224 


115 CALL “DISMOUNT”,C1 


This example tells the system that the device with its address in C1 is to be 
dismounted. 


а 


Example 2: 


155 CALL “DISMOUNT”,2 


шз ша 


This example informs the system that the device with the address 2 is to be 
dismounted. 


v- 


2 


та 2 22 


ша Ша а-а 22 
2 
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CALL “DREL” (Device Release) 


See Appendix E for information on using 


this command with the Extended Memory 


Purpose File Manager. 


When a device is reserved it must subsequently be released in order to open files. The 
CALL “DREL” command releases the addressed device previously reserved with a CALL 


“DRES” command. 


SYNTAX FORM 


CAL “DREL”, numeric expression 


DESCRIPTIVE FORM 


CALL “DREL”, device address 


Field Definitions (Descriptive Form) 


CALL "DREL" These are the keywords for this command. Entry may be made 
as shown in SYNTAX FORM. 


device address The device address is shown on or near the front of the device. 


General Information 


The addressed device must be reserved, or the statement will be ignored. 
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COMMAND DESCRIPTIONS 


22-2 


CALL “DREL” 

1 Prerequisites 
П Мопе. 
П Examples 
! 

Example 1: 
П 110 CALL "DREL",B2 
1 This example releases the device that has its address stored т B2. 
! 

Ехатріе 2: 
L] 
1 175 CALL "DREL",2 
П This example releases the device with address 2. 
^N 
Л 
П 
1 
1 
1 
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COMMAND DESCRIPTIONS 


CALL “DRES” 
” Н 
CALL “DRES” (Device Reserve) See Appendix E for information on using 
this command with the Extended Memory 
Purpose File Manager. 


5-34 


Тһе CALL "DRES" command provides exclusive device control. This command is 
necessary when formatting a file or when the CALL “COMPRS” or CALL “DUP” 
commands are executed. 


SYNTAX FORM 


CAL "DRES", numeric expression 


DESCRIPTIVE FORM 


CALL “DRES”, device address 


Field Definitions (Descriptive Form) 


CALL "DRES" These are the keywords for this statement. Entry may be made 
as shown in SYNTAX FORM. 


device address The device address may be seen on or near the front of the 
device. 

General Information 

АП files on the device must be closed before command execution. An error message 


appears if there are any open files. This command may be executed even if the disc is 
missing or the device is not up to speed or has an open device door. 


REV, OCT 1982 4907 & EXTENDED MEMORY OPERATOR'S 


= ат {т г 


С 


— 9 
-— 


( 


( 
Кече 


t 
-— 


Іс. 


а 
—— 


C | 
= а 


— гс 
—— — 


( 


-— 
= 


C 


С 
п чочу 


—— 1m 


— 
e 


4 


—— 
—— 


с 


— 


COMMAND DESCRIPTIONS 


CALL “DRES” 
1 
t 
1 | Prerequisites 
! 
АП files must be closed and the clock must be set. 
1 
! 
Ехатріев 
П Example 1: 
" 105 CALL “DRES”,A 
4 
This example reserves the device with its address stored іп А. 
1 
д Example 2: 
| { 115 CALL “DRES”,3 
n This example reserves the device with address 3. 
ES 3 
1 
П 
1 
1 
1 
et 
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CALL “DSKERR” 
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CALL “ОЗКЕВН” 


See Appendix E for information on using 


this command with the Extended Memory 
Function File Manager. 


Place the error code and message from the last disk access in the provided target 
variable. 


Machines Supported 


4052, 4052A, 4054, 4054A with enhanced ROM Pack. 


SYNTAX FORM 


CAL"DSKERR', "string" 


DESCRIPTIVE FORM 


CALL "DSKERR", Target$ 


Command Field Definition 


Target$ The string variable to receive the error message. The string 
returned is never longer than 72 characters. 


Example 
10 DIM А$(350) 
20 CALL “DSKERR” A$ 
NOTE 
A useful 4050 feature, E= VAL(AS), picks the first error number out of a 


string. If AS is the "DSKERR" target value, the numeric variable E will 
receive the error message number. 


NOTE 


If ONERR was not set when the last error was produced, the target variable 
receives а null (“4”) value. 
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CALL “DSTAT” (Device Status) 
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Purpose 


ша 


COMMAND DESCRIPTIONS 
CALL “DSTAT” 


The CALL “DSTAT” command determines the status for the device addressed. See 


DEVICE AND FILE STATUS MESSAGES (Appendix A). CALL “DSTAT” generates and 


222 


stores the same status message produced by executing а CALL “MOUNT” command. 
CALL “ОЗТАТ”, unlike CALL “MOUNT”, also generates "full" file status messages on any 


open files, in addition to the device status message. 


SYNTAX FORM 


ша 


CAL “ОЗТАТ”, numeric expression, string variable 


рав | 


DESCRIPTIVE FORM 


з 2222 
2 


--- 


Field Definitions (Descriptive Form) 


223 


CALL “ОЗТАТ” 


раа | 


device address 


— 


target string variable 


ша 22022 222 


E 


CALL “ОЗТАТ”, device address, target string variable 


These are the keywords for this command. 
Entry may be made as shown in SYNTAX 
FORM. 


The device address may be seen on or near 
the front of the device. 


The file and device status messages are 
sent to this location. This string variable 
must first be dimensioned large enough to 
hold the device status message. 


The device status message is 186 charac- 
ters. Each “ІШІ” file status message is 189 
characters plus the number of characters in 
the F.l.s. 
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COMMAND DESCRIPTIONS 
CALL “DSTAT” 


General Information 


See DEVICE AND FILE STATUS MESSAGES (Appendix A) for message details. 


Prerequisites 


Set clock. 


Example 


190 DIM А$(3000) 
200 CALL “DSTAT”,2,A$ 
210 PRINT А$ 


This example first dimensions А$ to 3000 bytes. It then requests the status of the 


device at address 2. The message(s) is stored in A$. Execution of line 210 then 
prints the messages on the Graphic System screen. 
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COMMAND DESCRIPTIONS 
CALL “DUP” 
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CALL “DUP” (Duplicate) 


See Appendix E for information on using 
this command with the Extended Memory 


Purpose File Manager. 


ыз 


Тһе CALL “DUP” command copies all files and libraries from one device to another. This 
command is often used to group all unused spaces in a disc into a single contiguous 
space on a different disc. This command may be used to recover data from a defective 
disc. This command is not applicable to single device systems. 


а 222 


SYNTAX FORM 


ыз 


CAL “DUP”, numeric expression, numeric expression, numeric expression 


sd 


DESCRIPTIVE FORM 


CALL “ООР”, source device address, target device address, compress control 


2 


E rae 


Field Definitions (Descriptive Form) 


-- 


CALL “DUP” These are the keywords for this statement. Entry may be 
made as shown in SYNTAX FORM. 


—J 


source device address The device address is shown on or near the front of the 
П device. This is the device that contains the files to be 
' copied. 

target device address The device address is shown on or near the front of the 


device. This is the device which will receive the information. 


compress control When 1 is entered, all free space transmitted will be 
collected and grouped as one contiguous space on the 
target device. When 0 is entered, all free space transmitted, 
except that contained within files, will be collected and 
grouped as one contiguous space on the target device. 


12222 22 3 


> 


L1 
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CALL “DUP” 
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General Information 


€ The disc receiving the information must first be formatted. Any entry in the master 
password field in the volume label on the new disc is replaced by the master 
password being transmitted from the old disc. No other volume label information 
from the output disc is copied to the new disc. 


e When the CALL "DUP" command is executed, ALL INFORMATION PREVIOUSLY 
STORED ON THE TARGET DEVICE IS ERASED. 


€ All programs transmitted are duplicated as whole entities. No files are duplicated 
in "scattered" form. 


@ This command is ignored if more than eight files are open. 


e The CALL "DUP" command does not transfer information to the internal magnetic 
tape or any outside device. 


Prerequisites 


A CALL “DRES” command must be executed on both devices. 


Examples 


Example 1: 

110 CALL "DUP",D1,D2,A1 
This example transmits all file information from the device with its address in D1 to 
the device with its address in D2. If A1 contains the value of 1, then all space, 


whether or not formatted as file space, will be duplicated as a single contiguous 
entity on the target device. 


Example 2: 
215 CALL "DUP",1,2,0 


АП file information is transmitted from device 1 to device 2. Since the last field is 0, 
only that space outside file boundaries is collected and grouped. 
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COMMAND DESCRIPTIONS 
ENHANCED CALL “DUP” 


2 


ENHANCED CALL“DUP” 


See Appendix E for information on using 
this command with the Extended Memory 


Machines Supported File Manager. 


4052/4052А and 4054/4054A with Enhanced ROM Pack. 


Enhancement 


кн» сз —з — 


In the enhanced File Manager ROM Pack for the 4052/4052A and 4054/4054А, 
CALL“DUP” has а new parameter value which allows fast “mirror image" disk duplication. 
The “compress control” parameter (which formerly allowed only values of О or 1) may 
now be set to 2. A setting of 2 causes the 4907 to very quickly duplicate the source disk 
onto the target disk. 


Three points should be kept in mind when using enhanced CALL"DUP": 
1. Enhanced CALL“DUP” does not require the target disk to be formatted. 


2. Enhanced CALL"DUP" requires that NO files be open. 


1 IL 2 3 
J 


3. The 4907 being used must have level |.3 or greater firmware. 


С\ 
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COMMAND DESCRIPTIONS | 
END |) 


ЕМО 


END, а 4050 Series BASIC command, stops all program execution, closes all files and 
returns control to the Graphic System’s keyboard. 


L 
Purpose L 
| 


C 


SYNTAX FORM 


END 


DESCRIPTIVE FORM 


END 


Le es Е 


C 22 


General Information 


Executing the END command does not affect the current device or the current library. | 
Prerequisites | 
Мопе. 
L 
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COMMAND DESCRIPTIONS 
CALL “FFRMT” 


2 


CALL *FFRMT" (Fast Format) 


See Appendix E for information on using 
this command with the Extended Memory 


Purpose File Manager. 


The CALL "FFRMT" command operates like CALL “FORMAT”. The only difference is that 
this command does not perform a surface analysis. Instead, the bad block or sector 
information from the existing volume label is placed on the new volume label created with 
this CALL "FFRMT" command. As a result, the formatting is faster. 


Syntax, Descriptive Forms, and Field Definitions 


These are identical to those used in the CALL "FORMAT" command, with the keywords 
CALL “FFRMT” replacing CALL “FORMAT.” 


General Information 


Attempting a CALL “FFRMT” on a disc not previously formatted or a disc with a damaged 
volume label results in an error message. 


Да» аа а 


Unless full formatting (CALL "FORMAT" is carried out, bad block or sector information 
carried over from the previous formatting with a CALL “FFRMT” command may prevent 
full use of the disc. 


This command automatically executes CALL “MOUNT” after its execution, but no device 
status message is generated. 


Prerequisites 


Device must be reserved. 
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COMMAND DESCRIPTIONS 


ENHANCED CALL “FFRMT” 
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ENHANCED CALL'"FFRMT" 


See Appendix E for information on using 


this command with the Extended Memory 
Machines Supported File Manager. 


4052, 4052A, 4054, 4054A with enhanced ROM Pack. 


Enhancement 


A streamlined version of the CALL“FFRMT” command is available with the enhanced 
ROM Pack. Since the “volume number” and “number of volumes in a series" must always 
be 1,1 on a 4907, the enhanced ROM Pack allows these parameters to be omitted. The 
enhanced ROM Pack also provides a default master password of '"' (null) if you do not 
give a master password. The new ROM Pack provides directory block allocation (chains) 
0f 10,10,1,1,1. This allocates ample directory space for first and second level libraries 
and sufficient space for less common lower level libraries. 


p IES. 


Е 


БҮМТАХ ҒОНМ 


CAL“FFRMT” numeric expression,“string”,“string”,“string” 


4 


DESCRIPTIVE FORM 


CALL“FFRMT’” device address, ‘volume identification", “owner name" 
[master password"] 


Co L. 


The command field definitions are identical to those of the original CALL“FORMAT” and 
CALL“FFRMT” commands. 


C 


гы е сеа лр Е Е 
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COMMAND DESCRIPTIONS 
CALL “FILE” 


2 


CALL “FILE” 


ша M a 


Purpose 


The CALL “FILE” command generates a file status message for the specified file and 
stores it in a string variable. Status messages for groups of files may be generated also. 


SYNTAX FORM 


CAL"FILE", numeric expression, "F.I.", string variable 


DESCRIPTIVE FORM 


CALL "FILE", device address, "F.I.", target string variable 


^ Field Definitions (Descriptive Form) 


CALL "FILE" These are the keywords for this command. Entry may be 
made as shown in SYNTAX FORM. 


device address This is the address of the device containing the disc. The 
address is shown on or near the front of the device. 


pm x ол мч —3 4 I. 3 


F.I. This is the F.I. for the file to be accessed. Status messages 
from multiple files may be generated with use of special 
characters in the F.I. See SPECIAL CHARACTERS in 
Section 4. Passwords specified in the CREATE command 
are not necessary when writing the Е.І. for this command. 


UN 2a 


An F.I. must be in quotes. 


target string variable This is the location to which the message or messages will 
be sent. This variable must first be dimensioned large 
enough to accommodate the incoming messages. Each full 
file status message is 189 characters long plus the 
characters in the Р.І‘. 


чал — — 


a If the file does not exist, the target string receives a null 


: string. 
П 
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C 
Г du o. oL 


General Information 
All messages generated are "full file status" messages and contain pertinent times and 
dates, file space details and the complete F.l. See DEVICE AND FILE STATUS MESSAGES 


(Appendix A) for details on the file status messages. 


A CALL "FILE" command may be executed even when the device has been reserved. The 
command may also be executed without a prior OPEN command. 


This command will be ignored if more than eight files are open. 


Е. UG 


Prerequisites 


[ 


Disc must be mounted. 


E 


Examples 


Е 


Assume SCRATCHLIB is the current library. 


Example 1: 


C 
С C 


100 CALL "FILE",2," eMYLIBRY #”,A$ 


This example accesses device 2 and generates status messages for all files in 
MYLIBRY. The messages are then stored in А$. 


C 


Example 2: 


p 


100 CALL "FILE", А, А$,В$ 


This example accesses the device specified in A and generates status messages for 
the file or files specified іп A$. The messages are then stored in В$. 


Е 


С. 
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COMMAND DESCRIPTIONS 
CALL “FMVALS” 


Ro 221 


CALL *FMVALS" (File Manager Values) 


See Appendix E for information on using 


this command with the Extended Memory 
Purpose File Manager. 


Тһе CALL "FMVALS" command sends the number of the current device to the numeric 
variable specified and the name of the current library to the string variable specified. 
These values can be displayed by recalling the variables. 


I. сл | 


SYNTAX FORM 


CAL "FMVALS", numeric variable, string variable 


сша eee 


DESCRIPTIVE FORM 


1 CALL "FMVALS", target numeric variable, target string variable 
Field Definitions (Descriptive Form) 
П CALL "FMVALS" These are the keywords for the command. They may 
| бе entered as shown іп SYNTAX FORM. 
i target numeric variable This is where the address of the current device is 
1 stored. 
target string variable This is where the name of the current library is 
n stored. 
П 4907 & EXTENDED MEMORY OPERATOR'S REV, OCT 1982 5-47 


COMMAND DESCRIPTIONS З 
CALL "FMVALS" || 


General Information |] 
The current device is specified by the UNIT command. The current library is specified by || 
the CALL "USERLIB" command. Тһе defaults аге О for the device and SCRATCHLIB for 


the current library. 


Prerequisites 


None. 


Example 


100 CALL "FMVALS",A,AS 


C 
D X UE 


C e 
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COMMAND DESCRIPTIONS 
CALL “FORMAT” 


Ша сша 


CALL “FORMAT” 


See Appendix E for information on using 
this command with the Extended Memory 


Purpose File Manager. 


The CALL “FORMAT” command prepares a new disc for data storage. The command will: 


€ Record a volume "label" on the disc.The volume label contains disc identification 
and specification data entered in this command. 


€ Look for bad block or track locations and then place this information on the label. 


The information on the label may be reviewed by executing CALL “ОЗТАТ” or 
CALL “MOUNT”. 


био o 3 1 мл 


SYNTAX FORM 


CAL“FORMAT”, numeric expression, "string", numeric expression, numeric ex- 
pression, "string", "string", numeric expression, numeric expression, numeric 
expression, numeric expression, numeric expression. 


2 


с ша 2222 


DESCRIPTIVE FORM 


CALL“FORMAT”, device address, “volume identification", volume number, number 
of volumes, "owner I.D.", *master password", 1st level chains, 2nd level chains, 
3rd level chains, 4th level chains, 5th level chains. 


Field Definitions (Descriptive Form) 


шэ cR с-та 


CALL "FORMAT" These are the keywords for this command. 
The entry can be made as shown in SYNTAX 
FORM. 

device address The device address is shown on or near the 


front of the device. 


volume identification This entry is the "name" of the disc. The 
entry may be 1 to 10 characters. The first 
character must be alphabetic; the rest may 
be alphanumeric. The volume 1.0. must be in 
quotes: “ТОМ”. 


4907 & EXTENDED MEMORY OPERATOR'S REV, OCT 1982 5-49 


pms сз 22 L3 а 22 


COMMAND DESCRIPTIONS 
CALL “FORMAT” 


volume number 
number of volumes in series 


owner identification 


master password 


1st level chains 
2nd level chains 
3rd level chains 
4th level chains 
5th level chains 
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Enter 1. f 
These values are not implemented 
for the 4907 File Manager. 


Enter 1. 


This entry can indicate the name of the 
person formatting the disc, the department 
with files on the disc, the primary user, etc. 
The entry can be up to 24 characters, which 
may be any combination of letters and 
numbers. The owner I.D. must be in quotes: 
“FRED”. 


The master password can be used in CALL 
“MRKBBG” and KILL. This affects the files 
in those commands, even if the specified 
passwords for those files are not used. 


The password can be up to 10 characters. 
The first character must be alphabetic; the 
rest must be alphanumeric. The master 
password must be in quotes: “RED”. 


The entry in each of these 5 subfields 
specifies the number of chains leading to 
consecutive storage levels. For example, an 
entry of 2 in the first subfield specifies that 
two chains lead to the first level. 


Each chain can be thought of as a separate 
storage aid searching through its level for 
the library or file you’ve specified. The more 
searchers you specify, the faster the item 
you are searching for will be found. With 
fewer items on a level, more chains bring 
diminishing returns. More chains require 
extra room on a disc. 
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General Information 


Whenever a volume (disc) is formatted, all existing data is erased. To be sure the operator 


COMMAND DESCRIPTIONS 
CALL “FORMAT” 


To compute the optimum number of chains 
between levels, divide the expected number 
of files or libraries at any level by 5. The 
result is the approximate number of chains 
leading to that level (with maximum of 10 
and minimum of 1). For example, if you are 
formatting a disc with 
5 first level libraries 

25 second level libraries 

50 third level files 

No fourth or fifth level data 
then the entry in this field would be 1, 5, 10, 
1, 1. 


If your disc will contain no libraries (except 
first-level default libraries), the level chains 
should be 1, 10, 1, 1, 1. 


does indeed intend a CALL "FORMAT" command, the following message always appears 


after initiating CALL “FORMAT”: 


FORMAT REQUESTED, OK TO DESTROY DATA ON DEVICE 0? 


Enter YES to complete the formatting procedure. 


The amount of free (available) space remaining after a CALL "FORMAT" command may 


be determined by executing CALL “ОТАТ”. 


This command automatically executes CALL “MOUNT” after its execution, but no device 


status message is generated. 


The only way volume label information may be changed is by executing a CALL "DUP" 
command and copying all information to another disc. 


Prerequisites 


Device must be reserved. 
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COMMAND DESCRIPTIONS 
CALL “FORMAT” 


г >ы 
Ехатр!е$ МЛ IE 
Bl 
ы 
Ехатр!е 1: 
{ 
CALL'"FORMAT',2,"MEDCOSTS",1,1,"HOSP","PASS" ,1,10,1,1,1 li 
This example accesses the disc in device 2 and specifies its name as "MEDCOSTS", i 
its identification number as 1, the number of volumes involved as 1, the owner as i 
“HOSP”, and “PASS” as the master password. The number of 1 $1, 2nd, 3rd, 4th, and 
5th level chains are 1,10,1,1,1, respectively. || 
Example 2: 
CALL“FORMAT”,A,A$,B,C,B$,C$,D,E,F,G,H |. 
This example accesses the disc specified in A апа specifies the identifying name |) 
located іп A$. The identification volume number (which must бе 1) is located іп В, 
the number of volumes (which must be 1) is located in C, the owner’s name is 
located in B$ and the master password located in C$. The number of 1st, 2nd, 3rd, || 


4th and 5th level chains аге located in D, Е, F, С апа H, respectively. 
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COMMAND DESCRIPTIONS 
ENHANCED CALL “FORMAT” 


= 
2 


ENHANCED CALL“FORMAT” 


=} 


See Appendix Е for information on using 
this command with the Extended Memory 


Machines Supported File Manager. 


ша 


4052, 4052А, 4054, 4054А with enhanced ROM Раск. 


pos ) 


Enhancement 


A streamlined version of the CALL“FORMAT” command is available with the enhanced 
ROM Pack. Since the “volume number” and “number of volumes in a series” must always 
be 1,1 on a 4907, the enhanced ROM Pack allows these parameters to be omitted. The 
enhanced ROM Pack also provides a default master password of “ ” (null) if you do not 
give a master password. The new ROM Pack provides directory block allocation (chains) 
of 10,10,1,1,1. This allocates ample directory space for first and second level libraries 
and sufficient space for less common lower level libraries. 


pes шл 22-2 


SYNTAX FORM 


CAL“FORMAT”, numeric expression,‘‘string”,“‘string’”,“‘string” 


- 


2 


DESCRIPTIVE FORM 


CALL"FORMAT" device address,"volume identification", “owner name" 
[master password"] 


ша 2 22 


Тһе command field definitions are identical to those of the original CALL"FORMAT" and 
CALL‘“FFRMT” commands. 


2 
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COMMAND DESCRIPTIONS 


CALL “HERRS” 
“ 3 
CALL "HERRS (Hard Error Status) See Appendix E for information on using 
this command with the Extended Memory 
Purpose File Manager. 
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Тһе CALL “НЕВВ$” command is a diagnostic too! only. This command allows a user to 
tell if the device (disc and drive) or the host is responsible for system malfunctions or 
slow downs. This command returns disc and drive hard and soft error information to the 
variables specified. Since CALL “HERRS” normally is used in diagnostic programs, itis 
not required in day-to-day system operation. 


SYNTAX FORM 


CAL "HERRS", numeric variable, numeric variable, numeric variable, numeric 
variable, numeric variable 


DESCRIPTIVE FORM 


CALL “НЕНН5»”, device address, по. of retries in last МО, no. of accumulated retries, 
no. of successful I/O recoveries, no. of unsuccessful ИО operations 


Field Definitions (Descriptive Form) 


CALL "HERRS" These are keywords for this command. Enter 
as shown in SYNTAX FORM. 


device address The device address is shown on or near the 
front of the device. 


number of retries last I/O This counter indicates the number of retries 
attempted during the last I/O operation, to a 
maximum of 255. 


This counter indicates the total number of 
retries since the last power up, to a maxi- 
mum of 65,335. 


number of accumulated retries 


number of successful ИО recoveries This counter indicates the total number of 
МО operations that have been successfully 
recovered after one or more retries, to a 
maximum count of 65,535. These are soft 
errors. 
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COMMAND DESCRIPTIONS 
CALL “НЕВВ$” 


number of unsuccessful I/O operations This counter indicates the total number of 
1/O operations that have not been success- 
fully recovered, to a maximum count of 
65,535. These are hard errors. 


General Information 


Although “НЕВВ$” stands for “HARD ERROR STATUS”, this command documents both 
hard and soft error frequency. 


Whenever the system increments the hard error counter by one, an error message is 
displayed. 


it is not necessary to execute the CALL *HERRS" command to initiate any of the 
counters, since they function independently. CALL “НЕНН5” is used only to access the 


information. The number of retries required before the hard error counter is updated may 
vary. See the 4907 Service Manual. 


Prerequisites 


None. 
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INIT 
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INIT (Initialize) 


Purpose 


This command resets all string variable, array variable, and numeric variable values to an 


undefined state. 


This is a 4050 Series BASIC command. It is included here because it directly affects 


4907 system operation. 


SYNTAX FORM 


INIT 


DESCRIPTIVE FORM 


INITIALIZE 


General Information 


Execution of this command closes all disc files, sets the current device to zero (0) and 
specifies "SCRATCHLIB" as the current library. INIT may be used to close sequential files 
which have been opened for full access (F) without losing any of the files. 


Prerequisites 


None. 
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INPUT 


Purpose 


=э 


Тһе INPUT command reads АЗСИ data that has been stored in the designated file with a 
PRINT command. It operates like the 4050 Series BASIC INPUT command with the 
following exceptions: 


222 


Ф The lfn (logical file number) specified іп the preceding OPEN command must be 
entered. This 1/О address tells the system which disc file to access. 


sat 222 


e Random, as well as sequential files, may be INPUT. This means that, unlike 


magnetic tape files, it is possible to directly access a particular location in the file. 


€ The primary address character is “#”. 


лей I3 


SYNTAX FORM 


2 


array variable array variable 
INP # constant [numeric expression] : 4 string variable String variable 
numeric variable numeric variable 


DESCRIPTIVE FORM 


INPUT # Ifn [record number] : 


ша 21 


target variables | target variables | 
i alee 


for incoming data |” for incoming dat 


I 


Field Definitions (Descriptive Form) 


INPUT This is the keyword for this command. It may be entered as 
shown in SYNTAX FORM. 


# ifn Logica! file number: This number must match the Ifn specified in 
the OPEN command. 


аса cl 2 
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COMMAND DESCRIPTIONS 


INPUT 


5-58 


record number 


target numeric 
variables for 
incoming data 


An entry is necessary in this field if you are inputting from a 
random file. An entry of 1 or greater places the logical file pointer 
at the first string in the record of that number. 


No entry is necessary in this field if you are inputting from a 
sequential file. However, if the statement is part of a program 
used to retrieve random file information one time and sequential 
file information the next, a numeric variable must be entered. See 
Example 4. 


These entries specify where the string or parts of the string is 
to be sent. 


General Information 


€ An INPUT command can only read ASCII information placed in the file with а 
PRINT command. 


ө For programming examples, see USING PRINT AND INPUT IN A PROGRAM 
(Appendix C). 


NOTE 


The End Of Record character for ASCII format files is a Carriage Return. 
Reaching the end of an ASCII record will not generate an interrupt (with 
respect to an ON EOF .. THEN... statement). 


Prerequisites 


File must be open and in ASCII format. 


Examples 


Example 1: 


INPUTTING NUMERIC VALUES FROM A RANDOM FILE 


330 INPUT #3,10:A,B,C 
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COMMAND DESCRIPTIONS 
INPUT 


This example places the logical file pointer at the beginning of record 10 in the file 
associated with Ifn З. The system then finds the first numeric value in the first string. 


- That value is stored in A. The system continues to search through record 10, string 


by string. If no further values are found, a search is begun through record 11. If none 
are found, the next record is searched and so on. (Remember, everything entered in 
the PRINT command up to the first Carriage Return is considered a single string. 
Everything between the first Carriage Return and the second Carriage Return is also 
considered a single string and so on.) Eventually, if a second and third value are 
located, they are stored in B and C. 


If less than three values exist in the entire file, an error message appears. 
Example 2: INPUTTING STRINGS FROM A RANDOM FILE 

430 INPUT #3,12:A$ 
This example places the logical file pointer at the beginning of record 12 in the file 
with Ifn 3. The system then reads everything in that record up to the first Carriage 
Return and stores it in A$. 
Example 3: INPUTTING A STRING FROM A SEQUENTIAL FILE 


410 INPUT #3:A$ 


INPUT will start at the current pointer position in п З. The system then reads 
everything in the next string and stores it in A$. 


Example 4: INPUTTING A STRING FROM A RANDOM OR SEQUENTIAL FILE 
140 INPUT %4,А:А% 


This retrieves a single string from the file and places it in AS. If =0 and this isa 
sequential file, this command inputs the first string past the current pointer position. 


If A=1 or greater and this is a random file, the string in the record (identified in A) is 
input. 
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KILL 
Purpose 


The KILL command deletes single files, groups of files or all files on a particular disc. 


SYNTAX FORM 


KIL “ЕЛ” [string] 


DESCRIPTIVE FORM 


KILL “ЕЛ” [master password] 


Field Definitions (Descriptive Form) 


KILL This is the keyword for the command. It may be entered as 
shown in SYNTAX FORM. 


Р.І. The file or files represented бу the F.I. entry will all be deleted. 
The files must be closed and assigned passwords specified. 


Any Р.І. must be in quotes. 

master password if a master password was specified when the disc was originally 
formatted, it may be entered here. If the master password is 
entered, all closed files represented by the F.I. will be deleted. 


This will occur even if passwords normally required in the Р.І. are 
not used. 


A master password must be in quotes: "RED". 


General information 


Libraries cannot be deleted unless the disc is reformatted. This is true even though all 
subsequent files may have been deleted. 


This command will not be completed if more than eight files are open. 
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COMMAND DESCRIPTIONS 


; КІШ. 
ey a 
| Examples 
‘4 
Example 1: 
q 140 KILL “Ж” “FRED” 
1 This example deletes all closed files іп the current library, whether or not the files or 
preceding libraries contain passwords. See SPECIAL CHARACTERS in Section 4 for 
a full description of the use of “#” and other special characters. 
П Ехатріе 2: 
n 210 KILL “@MYLIBRY/A/B/C” 
1 If file “С” is closed and contains no password, this example deletes it. 
f Example 3: 
П 470 KILL “$A/B.*” 
" This example kills all closed “В” files contained in SYSLIB and library “А” when 
! : \ those files contain any kind of extension (including blank extensions). 
n 
n 
1 
! 
1 
è 
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CALL “MOUNT” 
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CALL “MOUNT” 


See Appendix E for information on using 


this command with the Extended Memory 
Purpose File Manager. 


The CALL “MOUNT” command tells the system that the disc is in place and may be used. 
This command also generates a device status message identical to that generated by the 
CALL “ОЗТАТ” command. If CALL “MOUNT” is not executed, the system has no way of 
knowing if the disc is in place, that it is turned on, etc. The system must be informed with 
this command. 


SYNTAX FORM 


CAL “MOUNT”, numeric expression, string variable 


DESCRIPTIVE FORM 


CALL “MOUNT”, device address, target string variable 


Field Definitions (Descriptive Form) 


CALL “MOUNT” These are the keywords for this command. 
Entry may be made as shown in SYNTAX 
FORM. 

device address The device address is shown on or near the 


front of the device. 


target string variable This is the location to which the device 
status message is sent. This string variable 
must first be dimensioned large enough to 
accommodate the incoming messages. Each 
device status message is 186 characters. 
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COMMAND DESCRIPTIONS 
CALL “MOUNT 


2 


223 


General Information 


An error message appears if the device is not powered up, is not up to speed, or a CALL 
"SETTIM" command has not been executed. 


— 3 


Prerequisites 


1 беі сіоск. 

ў 

П Examples 
Example 1: 


рів | 


100 CALL “МООМТ”,2,А% 


1 


This example tells the system the disc іп device 2 is ready for use апа sends the 
device status message to A$. 


— сз 
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COMMAND DESCRIPTIONS 
CALL “MRKBBG” 
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CALL “МАКВВС” 


(Mark Bad Block Group) E nid. with the Extended Memory 


See Appendix E for information on using 


Purpose 


The CALL “MRKBBG” command tells the system that there are defective areas on the 
disc that are not to be used. This command is necessary only after Error Message 15 
appears specifying the address of defective tracks or sectors. CALL "MRKBBG'" is 
executed with this address in the last field. The defective space will not be used for 
subsequent data storage. This command is not commonly used in a program. 


SYNTAX FORM 


CAL “MRKBBG”, numeric expression, string, string, string 


DESCRIPTIVE FORM 


CALL “МАКВВС”, device address, volume I.D., master password, address of 
defective space. 


Field Definitions (Descriptive Form) 


CALL "MRKBBG" These are the keywords for this command. Enter as shown in 
SYNTAX FORM. 


device address The device address is shown on or near the front of the device. 


volume 1.0. This entry must be the same as that specified during the CALL 
“FORMAT” or CALL "FFRMT" command. If the volume I.D. is 


unknown, a CALL “ОЗТАТ” command displays this disc informa- 


tion. The volume 1.0. must be entered in quotes: “ТОМ”. 


master password The entry here must be the same as the entry in the CALL 
“FORMAT” or CALL "FFRMT" command. If there was no 
password but simply a null string (^") entered in that field, that 
string must also be entered here. 


Any master password must be in quotes: "RED". 
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COMMAND DESCRIPTIONS 
CALL "MRKBBG" 


2 


address of defective The entry in This field must match the first eight digits displayed 
space in the last field of Error Message 15. This is the message that 
appears when device hard errors occur. These digits indicate 
the number and location of the blocks causing the errors. 
The last two digits in the last field of Error Message 15 indicate 
whether the error is the result of mechanical or bad block 
problems. See General Information below. 


The address must be in quotes. 


General Information 

To mark a bad block group follow this procedure: 

1. Write down location of bad block as shown in error message. 
2. Copy the disc using the DUP routine. 


Close all files. 


3 


4. Reserve the device. 
5. Delete bad file. 
6. Execute CALL "MRKBBG'" with location of bad block group. 


If the CALL "MRKBBG" command is successfully executed but hard error messages 
continue, the problem is more likely one of hardware operation rather than defective areas 
on the disc. Even though Error Message 15 indicates the number and location of "bad 
blocks," the message may actually be reflecting a malfunctioning read/write head or 
similar problem. If execution of CALL “МАКВВС” does not end І/О problems, check the 
last two values in the error message (NN) against the list of specific problems in the 4907 
File Manager Service Manual. 


а A011 e С 


If volume 1.0. or master password is entered incorrectly, the device must be dismounted 
and remounted before re-executing the command. This is necessary because the free 
space will show a decrease, but, in fact, the bad blocks will not have been marked. 


If the volume 1.0. or master password has been incorrectly entered in a CALL “MRKBBG” 
command, a subsequent CALL “СУЗТАТ” command will show that the free space has 
been decreased. The disc, however, will NOT be marked. 


2 
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COMMAND DESCRIPTIONS 
CALL "MRKBBG" 
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C 


Prerequisites 


Device must be reserved. 


Example 


г. UE 


The system has accessed device 1 with the volume 1.0. of "SPECS." The master 
password is "LAB." The system is executing an І/О operation when this message 
appears: 


ERROR 15 DEVICE МО ERROR 010001FA-NN 
After following the procedure in General Information, enter and execute the following: 


CAL"MRKBBG",1,"SPECS","LAB'","010001FA" 


Е. сина C 


The bad biocks аге marked, апа no further attempts are made by the system to РАМТ ог 
WRITE data to them. 


С 


г 
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COMMAND DESCRIPTIONS 
CALL “NEXT” 


2 


“ 33 
CALL NEXT See Appendix E for information on using 
this command with the Extended Memory 
Purpose File Manager. 


Во шл 1. | 


The CALL “NEXT” command opens the next file in a series of files opened by an OPEN 
“G” (group) command. As each new file is opened, the CALL “NEXT” command generates 
a file status message which is sent to the target string variable. 


з 


SYNTAX FORM 


CAL "NEXT", numeric expression, string variable 


DESCRIPTIVE FORM 


CALL “NEXT”, Ifn, target string variable 


2 


Field Definitions (Descriptive Form) 


CALL "NEXT" These are the keywords for the command. 
They may be entered as shown in SYNTAX 
FORM. 


п Logical file number. This number must ре 
the same as specified in the previous OPEN 
command. 


target string variable As each new file is opened, its file status 
message is sent to this string variable. No 
status messages will be generated if a null 
string (“’) is entered here instead of a string 
variable. 


Any string variable used for file status 
messages must be dimensioned large 
enough to contain the information. Each full 
file status message is 189 characters plus 
the characters in the F.I. 


5 
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COMMAND DESCRIPTIONS 
CALL “NEXT” 
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General Information 


ө Га CALL “NEXT” command is executed after a normal OPEN command (not a 
group OPEN), an error message is displayed. 


ө If an OPEN “С” command locates a single file but the first CALL “NEXT” finds no 
files, a null string is generated and stored in the target string variable. 


e |f OPEN “О” locates no files, the first CALL “NEXT” generates an error message. 


ө if a CALL “NEXT” has located no files the following CALL “NEXT” generates an 
error message. 


e When CALL “NEXT” is executed, the current file is closed. 


€ CALL "NEXT" always executes on a file in the current device. See UNIT command 
description. 


Prerequisites 


File must have been opened with an OPEN “G” command. 


Examples 


Example 1: 


800 CALL"NEXT",2,A$ 


This example opens the next file in a group of files that were specified in an earlier 
OPEN “G” command as Ifn 2. The file status message is sent to A$. 


Example 2: 
450 CALL“NEXT”,A,BS 


This example opens the next file in a group of files specified т ап earlier OPEN “С” 
command. The Ііп stored іп A must be the same as that in the OPEN “С” command. 
The file status message is sent to B$. 
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COMMAND DESCRIPTIONS 
CALL “OFFERR” 


CALL“OFFERR” 


See Appendix E for information on using 


this command with the Extended Memory 
Function File Manager. 


Turn off the special File Manager error handling set with ONERR. 


Machines Supported 


4052,4052A,4054,4054A with enhanced ROM Pack. 


SYNTAX FORM 


Cal"OFFERR" 


DESCRIPTIVE FORM 


Call"OFFERR" 


Explanation 


The ROM Pack has a standard error-handling process. It displays an error message and 
halts program execution. You can replace this error handling procedure using CALL 
“ОМЕНН”, which sets error handling so that control is transferred to your own error 
handling routine. 


Тһе CALL "OFFERR" command returns the error handling process to the normal File 
Manager routine after a CALL “ОМЕВВ” has been executed. After CALL "OFFERR", the 
File Manager displays the error message and halts the program whenever a File Manager 
error occurs. 
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COMMAND DESCRIPTIONS U 
OLD | 
OLD || 
Ригрове 
Тһе OLD command loads а BASIC program in either binary ог ASCII format from the disc [| 
file into the Graphic System memory. 
SYNTAX FORM || 
OLD “F.I.” [string] 
DESCRIPTIVE FORM 
OLD "F.I." ["A"] i 
L 
Field Definitions (Descriptive Form) | | 
OLD This is the keyword for this command. 
РІ. This Ғ.І. must match the F.I. used when the program was saved. Ц 
А If the program was saved in ASCII form, this entry must appear. If the |! 
program was saved іп binary form, no entry is necessary. 
Li 
General Information 
€ An error message appears if the program is not found or is a data file. || 
ө if the program was originally stored т binary, it must be retrieved іп binary. The 
same applies to programs stored in ASCII. || 
€ Because this command executes an automatic DELETE ALL command as part of 
the operation, the current library is set to '"SCRATCHLIB." The current device is || 
ѕеї їо 0. 
€ If an ASCII file has been designated SECRET, it cannot be brought into memory || 
with OLD. (A secret ASCII program may, however, be appended into memory.) 
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COMMAND DESCRIPTIONS 


ша Шағыл | 


OLD 

^\ 
П Prerequisites 
П Disc must be mounted but device must not be reserved. File does not have to be open. 
П Ехатріеѕ 
| Ехатріе 1: 
П 140 OLD “@MYLIBRY/STOCKS” 
n This example transfers a binary program from the file "STOCKS" into Graphic 
! System memory. 
П Ехатріе 2: 

140 OLD “@ MYLIBRY/STOCKS” “A” 

П This example transfers ап ASCII program from the file “STOCKS” into Graphic 
п ^^ System memory. 
П 
П 
П 
П 
n 
П 
П 
от 
Т | 
П 4907 8 EXTENDED MEMORY OPERATOR'S REV, OCT 1982 5-71 


COMMAND DESCRIPTIONS н 
ОМ ЕОЕ || 
Vy | 

ON EOF (Оп End-Of-File) || 
Ригрозе Е 


This form of the 4050 Series BASIC ОМ... THEN statement allows continued program 
operation when the end-of-file is encountered. It is particularly useful when retrieving 
information from a sequential file of unknown length. 


C C 


SYNTAX FORM 


Е 


ОМ EOF (numeric expression) THE constant 


DESCRIPTIVE FORM 


ON EOF (Ifn) THEN line number 


C 
с C d 


Field Definitions (Descriptive Form) 
ON EOF THEN These are the keywords for the command. 


Ifn Logical file number: This is the same number that is assigned to a 
particular file in the OPEN.command. 


line number This line number is executed after encountering the end of the file. 


General Information 


Е. EI LE 


® If no ON EOF command has been entered in the program, an error message is 
generated when the end-of-file has been reached. 


C= 


e If the Graphic System is equipped with a CO1 (Bisynchronous Interface), it will 
have the logical file number 9. This can cause a problem if a disc file has been 
assigned a logical file number 9. If both devices are in use in the same program, 
separate ON EOF commands must be provided for each. 


Ez. 


€ See the ON... THEN command description in the 4050 Series Graphic System 
Reference Manual for further details. 


е 
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COMMAND DESCRIPTIONS 


са 222 


ОМ ЕОҒ 
П Prerequisites 
П Мопе. 
П Ехатріе 
120 ОМ ЕОҒ(2) ТНЕМ 140 
П This example executes line 140 when the end of file has been reached on the Ше 
represented by Ifn 2. 
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COMMAND DESCRIPTIONS 


[- X 


CALL “ONERR” 
! 4 
“ ” i 
VALE ONERB See Appendix E for information on using 
this command with the Extended Memory 
Function File Manager. || 
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Set error handling to transfer control to а user-written routine rather than execute the 
ordinary File Manager error process when a File Manager error occurs. L 
(See "Explanation" below.) | 


Machines Supported LI 


4052,4052A, 4054, 4054A with enhanced ROM Pack. 


ES 


SYNTAX FORM || 


CAL“ONERR” line-number | | 


DESCRIPTIVE FORM 


CALL"ONERR",line-number 


Command Field Definition 


line-number The starting line number of your special routine (subroutine) to 
handle File Manager errors. 


Example 


C 


20 CALL“ONERR”,9000 


E г 


SL 
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COMMAND DESCRIPTIONS 
CALL “ONERR” 


Explanation 


Ordinarily, when a File Manager error occurs, an error message is displayed on the 
Graphic System screen and program execution stops. 


The CALL “ONERR” command causes control to be transferred to a user-written error 
handling routine. This is equivalent to a GOSUB to the specified line number, and should 
be followed by a RETURN to return to the main program. The CALL *ONERR" command 
must be executed from a running program. 


There are several reasons you might want to use CALL “ONERR”. For example, you might 
wish to check that a peripheral is connected, a disk inserted in a drive, or similar operator 
responsibility has been carried out before the program continues. 


Special Considerations 


Since the File Manager and the 4052/40524 or 4054/4054A sometimes work on the 
same data, certain types of errors may not be trapped by CALL “ОМЕВВ” alone. By using 
the additional commands ON SRQ and ON EOI, you can insure that all errors are trapped. 


This may be as simple as adding the lines: 


100 ON SRQ 1000 
110 ON EO! 2000 


1000 RETURN 
2000 RETURN 


If your program already uses ON SRQ or ON EOI, your error handling subroutine will be 
called when control is passed back to the main program. 


"ONERR" is turned off and the standard error handling routine is restored whenever you 
do an INIT, DELALL, or OLD. In addition, when the program execution is temporarily 
stopped, “ОМЕНН” is temporarily turned off. 


NOTE 


A RENUMBER command will not update the line number parameter of a 
CALL "ONERR" command. After the RENUMBER command has been 
executed, you must manually change the line number specified in the 
CALL "ONERR" command. This may be avoided if the line number 
specified in the CALL "ONERR" command is less than 100. Line numbers 
less than 100 are not normally changed by the RENUMBER command. 
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OPEN 
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OPEN See Appendix E for information on using i 
this command with the Extended Memory 
File Manager. 


Purpose 


The OPEN command must be executed before the majority of file management апа I/O 
commands can be executed. See GENERAL SEQUENCE FLOW CHART in Section 2. This 


command allows the user to specify: Е 


€ A logical file number representing the file. This number eliminates the need for 
rewriting the F.l. in many subsequent commands. Ц 


@ Whether access is to be read and write, read only, ог update. 


ө Whether single or multiple files are to be opened. nel 

ө The string variable in which the file status message is to be stored. |! 

SYNTAX FORM L 

OPE "FI." 14071; constant, "string", string variable T5 

wae 

DESCRIPTIVE FORM || 

OPEN “F.I.” [“СВОУР”)]; Ifn, "type of access”, target string variable T 

Field Definitions (Descriptive Form) L 

OPEN This is the the keyword for the command. It may be entered as | 
shown in SYNTAX FORM. 

F.I. This entry is the F.I. of the file to be opened. Special characters Ц 


must be used when entering the F.I. in this field if multiple files 
are to be opened. See SPECIAL CHARACTERS in Section 4. 


t= 


“GROUP” This entry is required if multiple files are to be opened under 
one OPEN command. Only the character “С” must be entered. || 
File contents тау be binary or ASCII т random or sequential 
files. V || 
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COMMAND DESCRIPTIONS 


П ОРЕМ 
1 Ifn Logical file number: The number entered here must be an 
integer 1 to 9. This number is used to represent the Е.І. in 
subsequent commands. This eliminates the need for writing out 
[| the Е.І. each time. 
type of access This entry specifies the type of access intended for this file 
П during this OPEN. 
! 
Enter an “R” if you intend to only read from a file. 
П Enter a “Ц” if updating (adding to) а SEQUENTIAL file. No data is 
| destroyed if file is opened апа rewound, partial data is entered, 
Д and the file is then closed. 
| Enter ап “F” И writing to а RANDOM ог SEQUENTIAL file. Е 
indicates “FULL” access for read or write (all ИО operations). 
Л This entry must be іп quotes. 
If a SEQUENTIAL file is opened for full access (Е), the pointer is 
1 ! ) moved to the beginning о the file. If no reading or writing is 
| carried out апа the file is closed, the pointer remains at that 
point. This means that al! data past that point is lost. This does 
П not apply if files аге closed with INIT ог DELALL. If you have 
opened a sequential file for full access, you must READ or INPUT 
from the file (for example, store strings repeatedly into the same 
П string variable) until the End Of File is reached. This moves the 
pointer to the end of the data, and the file can be closed. 
"n To erase the contents of a sequential file, enter OPEN, then 
CLOSE, then OPEN. 
Л 
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OPEN 
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target string variable When the OPEN command is executed, a file status message is 
generated. This message is then stored in the string variable 
specified here. The parameters are: 


last date altered 

last date used 

date created 

number of current OPENS 
current bytes allocated 
number of bytes used 
record size 

file attributes 


The last field in the message shows the entire Е.І. for the file. 


Remember to dimension the string variable large enough to 
contain the file message; that is, DIM А%(300). The file status 
message is 189 characters plus the characters in the F.I. 


See DEVICE AND FILE STATUS MESSAGES (Appendix A) for 
further details. 


If OPEN "G" has been executed, the file status message sent to 
the string shows the status of the first file to be opened. If there 
are no files, the string variable will contain a null string (47, 


General information 


This command is executed on a file in the current device. See UNIT command description. 


If no UNIT command is previously executed, the system defaults to Device O. 


If files аге not created prior to an OPEN “С” command, an error message appears. 


Occasionally it is necessary to review what has just been entered. To do this, execute the 
CALL REWIND command. This positions the file pointer back to the beginning of the file 
without CLOSE command and another OPEN command. See FILE POINTER OPERATION 
(Appendix C) for further details. 


Hitting BREAK twice will also close files. However, this command also aborts program file 


control. 
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COMMAND DESCRIPTIONS 

q OPEN 
T Prerequisites 
П Disc must be mounted but device must not be reserved. 
Hy 
1 Examples 

Example 1: 
П 10 OPEN “$FOOD/PRODUCT/SUPPLIERS”;3,“R”,A$ 
T This example accesses "SYSLIB" and libraries “FOOD” and “PRODUCE.” It then 

opens the file "SUPPLIERS." The logical file number is specified as 3, the type of 

access is “В” (read only), and А$ is specified as the destination for the file status 
1 message. 

The arrow indicates the file selected in the SYSLIB storage structure shown in 
n Figure 5-1. 
n ^N 
л 
1 

2380-34 

1 Figure 5-1. Sample Storage Structure (4 Levels, 3 Files). 
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COMMAND DESCRIPTIONS 


OPEN |. 
Ехатріе 2: Е 


115 OPEN A$;5,B$,C$ | 


This example OPEN the file specified by the Е. in A$. The № is specified as 5, the 
character in B$ specifies the type of file access, and C$ is specified as the || 
destination for the file status message. 


Example 3: } | 
hed 
350 OPEN “@ MYLIBRY/HOSPITAL/STJOHNS 

X RES","G';S,"F",B$ i 
This example accesses "MYLIBRY;" “HOSPITAL” and “STJOHNS,” and all subse- 
quent files (#) with the extension "RES". Since а “С” is specified in the next field, | | 
this is a "GROUP" OPEN. If anything other than “С” is entered, an error message 
appears. 


The № is specified as 3, the type of file access is “F” (for FULL), and B$ is the 
destination for the file status message. р 
i 


The arrows indicate the files selected in the “MYLIBRY” storage structure shown in = 
Figure 5-2. || 
| | 

| 

ы 


1 


GYN.INT GYN.RES PSY.INT 


1 1 


2380-35 


i 
Figure 5-2. Sample Storage Structure (4 Levels, 5 Files). 4 
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COMMAND DESCRIPTIONS 


П ОРЕМ 
А ғ” 
П Opening Multiple Files. The following sample shows how multiple files on different 
devices may be opened, assuming there are two devices, with addresses 0 and 1. 

n 100 UNIT 0 

110 OPEN А%;2,В%,С% 
q 120 UNIT 1 
! i 130 OPEN D$;3,E$,F$ 

140 (various I/O operations to Ifn 2 and 3) 
1 
Щи 
‘4 : 
n 
! 
Л 
1 

; } 
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COMMAND DESCRIPTIONS 
PRINT 


PRINT 
Purpose 


The PRINT command stores ASCII data in the designated file. It operates like the 4050 
Series BASIC PRINT command with the following exceptions: 


ө The Ifn (logical file number) specified in the preceding OPEN command must be 
entered. This I/O address tells the system which disc file to access. 


е Random as well as sequential files may be printed. This means that, unlike 
magnetic tape files, it is possible to directly access a particular location in the file. 


e The primary address character is " €". 


SYNTAX FORM 


| | “string” numeric expression 
PRI # constant [numeric expression] : |USI Or : 


Emp а 


constant string 


DESCRIPTIVE FORM 


PRINT # Ifn [record number] : [USING 


| “format string" 
Ц | item to be printed ]]... [;] 


or | :][item to be printed 
IMAGE line number 


Field Definitions (Descriptive Form) 


PRINT This is the keyword for this command. It may be entered as shown in 
SYNTAX FORM. 


* fn Logical file number: The number entered here must match the Ifn 
specified in the OPEN command. 


5-82 REV, OCT 1982 4907 & EXTENDED MEMORY OPERATOR'S 


C 
vies 


Гг. 


aoe 
E 


— 
~ — 


C 


-—] С 
— a et 


C 


—— 


[ 


[E 


—— — — ғ. — 


Z< е 


— 
— 


t 


— 
мы 


С 


- 
-- 


СЄ (т 


Ша Шэ 


гесога 


==} соз ша 


COMMAND DESCRIPTIONS 
PRINT 


number An entry is necessary in this field if you are printing to a random file. 
The value of this entry must be 1 or greater. The logical file pointer is 
placed at the beginning of the record specified. 


No entry is necessary in this field if you are printing to a sequential 
file. However, if the statement is part of a program and is used to enter 
information in a sequential file one time and a random file another 
time, a numeric variable must be entered. 


1 USING See the 4050 Series Graphic System Reference Manual. 
, 
data item This is the item to be stored. It may be the actual constant or string 
f] constant, a numeric expression, the location of the item in memory (A, 
А$, etc.), or a combination. 
data item Same as previous field. 


22 3 


^^ ° 
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>. 
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General Information 


If you are updating a sequential file (that is, adding data to the end of existing 
information), “U” must be entered in the OPEN command. This places the logical 
file pointer at the end of the last item. PRINT then adds new data beginning at that 
point. 


Printing data to a record requires that all previous records be filled. See the file 
initializing program in SAMPLE PROGRAMS (Appendix F). 


If too much data is printed to a record in a random file the excess is placed in one 
or more following records. This destroys any existing data in those records. 


For examples of how to retrieve PRINTed information, see INPUT command 
description. 


For programming examples, see USING PRINT AND INPUT IN A PROGRAM 
(Appendix C). 
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COMMAND DESCRIPTIONS 
PRINT 


Prerequisites 


Disc must be mounted but device must not be reserved. File must be open and in ASCII 
format. 


Examples 
Example 1: PRINTING TO A SEQUENTIAL FILE 
140 PRINT %З:“ТОМ”; “241 MAIN, MILL CITY”;5464451 
The system considers TOM, 241 MAIN, MILL CITY 5464451 as a single string and 


stores it, starting at the current pointer position. After PRINT is executed, the pointer 
is located just past the CR (carriage return) at the end of the string. 


NE TOM241 MAIN, MILL CITY5464451 


BEGINNING POINTER ENDING POINTER 
POSITION POSITION 


Another string may be added by executing another PRINT command. The new 
information is recorded where the logical file pointer is located. The EOF mark is 
always moved along and placed just after the last CR. 
Example 2: PRINTING TO A SEQUENTIAL FILE 
135 PRINT #3: АФ 

This example functions exactly as Example 1 if: 

А$ = “ТОМ 241 MAIN, MILL CITY 5464451" 
Example 3: PRINTING TO A RANDOM FILE 

340 PRINT #3,40:“GRANT, TOM" ;"GEOL';2.5 
The system considers GRANT, TOM, GEOL and 2.5 as a single string and stores it 


that way at the very beginning of record 40 in Ifn 3. After PRINT is executed, the 
logical file pointer is located just past the CR at the end of the string. 


5-84 REV, OCT 1982 4907 & EXTENDED MEMORY OPERATOR'S 


ЄС АШ те 


— 
~~ 


г 


~ 


С 
; amma 


= 
-aa 


C 


I 


[5 


— 
~ 


Е.Г 


— = 
—— 


t 


— 
PE E 


C 


-— 
— 


E es. X 


C 


- ФС 
m 


{ 


С 
Bm 


= 


- 


2 


- 
- 


а. шл I I 3 


22 


—- 
«А. 


з 


2 


-e 


Бер lo lI. 3 


3 
LI s 


~ 
- 


22 — 22 
2 


COMMAND DESCRIPTIONS 


PRINT 
Record #40 с 
ЕИБЕЛЕНИВ i бш; eee n re 
BEGINNING POINTER ENDING POINTER 
POSITION POSITION 
Even if there is enough space left in the record, no additional strings may be added 
by executing another PRINT command; each additional PRINT starts at the 
beginning of a record. 
Printing to a random ASCII file must be done with great accuracy. If more 
data is transmitted than can be accommodated in the specified record, the 
data in the following record is overwritten. 
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READ 


Purpose 
The READ command reads binary data stored in the designated file with a WRITE 
command. It operates like the 4050 Series BASIC READ command with the following 


exceptions: 


€ The Ifn (logical file number) specified in the preceding OPEN command must be 
entered. This 1/О address tells the system which disc file to access. 


e Random as well as sequential files may be read. This means that, unlike magnetic 
tape files, it is possible to directly access a particular location in the file. 


e The primary address character is “%”, 


SYNTAX FORM 


string variable 
numeric variable 


array variable array variable 
REA # constant [ питегіс expression] : {string variable ; 


numeric variable 


DESCRIPTIVE FORM 


READ # їп [record number] : target variables | target variables | 


for incoming data |’ for incoming dat 


Field Definitions (Descriptive Form) 


READ This is the keyword for this command. The entry may be made as 
shown in SYNTAX FORM. 


* lfn Logical file number: The number must match the Ifn specified in 
the OPEN command. 


record number An entry is necessary in this field only if you are reading from a 
random file. An entry of 1 or greater places the logical file pointer 
at the first item in the record of that number. The READ starts 
from there. 
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COMMAND DESCRIPTIONS 
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READ 
П Мо entry is necessary in this field if you are reading from а 
sequential file. However, if this is part of a program used to read 
П random files one time, and sequential files the next, a numeric 
| variable must Бе entered. See Example 4. 
П target variables These entries specify where the item (or items) being read is to 
р for incoming data be sent. See the 4050 Series Graphic System Reference Manual 
for further details on array variables. 
П 
General Information 
П А READ command can only retrieve binary information placed in the Ше мин а WRITE. 
n For programming examples, see USING WRITE AND READ IN A PROGRAM (Appendix C). 
, 
1 Prerequisites 
L 
Disc must be mounted but device must not be reserved. File must be open and in binary 
а / ) format. 
2 H 
| | Examples 
q Example 1: READING NUMERIC ITEMS FROM A RANDOM FILE 
450 READ #3, 10:А,В,С 
П This example places the logical file pointer at the first item т record 10 in № 3, 
reads the first three items, which must all be numeric, and stores them in the 
| variables shown. The record number in this statement shows that this is a random 
! Ше. Unlike an INPUT command, а READ command stops looking when it encounters 
an EOR (End-of-Record). If the three items have not yet been found, an error 
E message is generated. 
Example 2: READING NUMERIC ITEMS FROM A SEQUENTIAL FILE 
I 610 READ Z3:A,B,C 
П Because this is а sequential file (no record number entered), READ starts at the 
current pointer position. The first three items past this position must be numeric 
f \ values. They are read and then stored in the variables shown. 
П 
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Example 3: READING STRINGS AND NUMERIC ITEMS FROM A RANDOM FILE 
740 READ #1,2:A$,B$,C 

This example reads the first three items in record 2 in Ifn 1. These items, which must 

be a string, a string, and a variable, in that order, are then stored in the target 


variables shown. 


Example 4: | READING STRINGS AND NUMERIC ITEMS FROM А RANDOM OR 
SEQUENTIAL FILE 


190 READ #5,B:A$,B$,C 
This reads the first three items. 


If B = O and the file is sequential, the system reads the first three items past the 
logical pointer position and places them in the variables shown. 


НВ = 1 or greater and the file is random, the system reads the first three items in 
the record of that number and places them in the variables shown. 


The first three items must be a string, a string, and a numeric value. 
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COMMAND DESCRIPTIONS 
CALL “RENAME” 
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CALL “RENAME” 
Purpose 
The CALL “RENAME” command is used to change the names of files, libraries, 


passwords, and extensions in F.I.’s. Іп some instances, changing names results in moving 
files to another library. This command is not generally used in a program. 


SYNTAX FORM 


CAL “RENAME”, numeric expression, F.I., Е.І. 


DESCRIPTIVE FORM 


кен» Шаты» кс Жалы» 0 Se | 


CALL “RENAME”, device address, old F.l., new F.I. 


1 — 
2 


Field Definitions (Descriptive Form) 


CALL “RENAME” These are the keywords for this command. Entry тау be made as 
shown in SYNTAX FORM. 


device address The device address may be seen on or near the front of the device. 


old F.I. The Е.І. of the file to be renamed is entered here. Special characters 
may be used. 


The F.l. must be in quotes. 


new Е.І. The new F.I. is entered here. 


c I а 3 


The ЕІ. must be in quotes. 


General Information 


1 


The CALL “RENAME” command works only on those files with a creation date earlier than 
the present date of the system clock. For example, if you wish to rename a file that has an 
inaccurate creation date of February 10, 1987, and the correct time of the system clock is 
July 14, 1978, CALL “RENAME” will fail. In fact, if the file creation date is only one second 
n ahead of the system clock, the command will fail. Therefore, the correct date and time 


P 


must always be used in the “SETTIM” routine. 
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COMMAND DESCRIPTIONS 
CALL “RENAME” 


This command operates much like COPY ... TO when the command is used to change the 


names of libraries, files, passwords or instructions. There are two exceptions: 
ө The CALL “RENAME” command will not copy files to another device. 


e When а file is moved using CALL “RENAME”, the file in the original location is 
erased and not retained as it is in COPY ... TO. 


This command will not be completed if more than eight files are open. 


Prerequisites 


Disc must be mounted but device must not be reserved. 


Examples 
Example 1: 
CALL"RENAME" 2,‘ ӘҮООВИВ/ТОМ/УАМЕ”,“Ә YOURLIB/TOM/BILL" 


This example changes the name of the file in the library "TOM" in YOURLIB from 


"JANE" to "BILL." 


YOURLIB YOURLIB 


TO 


2380-36 


Figure 5-3. Sample Storage Structure Illustrating How to Change File Names. 
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COMMAND DESCRIPTIONS 
CALL “RENAME” 


Example 2: 
CALL‘ RENAME”, 2,““@ YOURLIB/TOM/JANE”,“STOM/JANE”’ 


This example transfers the library “ТОМ” and the file “JANE” from YOURLIB to 
SYSLIB, as well as changing the F.I. 


YOURLIB 


SYSLIB 


TO 


2380-37 


Figure 5-4. Sample Storage Structure Illustrating How to Transfer Files From One Library to Another. 


Example 3: 
CALL“RENAME”,A,A$,B$ 
This example accesses the device with its address іп А and changes the F.I. in A$ to 


the Е.І. in B$. 


Multiple File Name Changing. Special characters (#, *, ?) are required to change more 
than one РІ. with a single CALL “RENAME” command. See CHANGING NAMES in the 
COPY ... TO command description. 
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CALL “REWIND” 
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CALL “REWIND” 


Purpose 


The CALL “REWIND” command allows the pointer to be positioned back to the beginning 
of a sequential file (after the header). This allows data just entered to be read or new data 
to be reentered without the usual CLOSE and subsequent OPEN command. This 
command is unnecessary for random access files since commands with the record 
number one (1) will accomplish the same thing. 


SYNTAX FORM 


CAL “REWIND”, numeric expression 


E Еле 


DESCRIPTIVE FORM 


E 


CALL “REWIND”, Ifn 


C 


Field Definitions (Descriptive Form) 


Е 


CALL “REWIND” These аге the keywords for the command. Entry тау be made as 
shown in SYNTAX FORM. 


С 


lfn This entry must be the same as specified in the original OPEN 
command for this file. 


General Information 


I-. Е 


See FILE POINTER OPERATION (Appendix С) for further details. 


| ыт 


This command is always executed on a file т the current device. Зее UNIT command 
description. 


Е 


Prerequisites 


File must be open. 
L 
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COMMAND DESCRIPTIONS 
CALL “REWIND” 


Example 
400 CALL “REWIND” 2 


This example rewinds the pointer to the beginning of the file identified Бу Ifn 2. 
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SAVE 


Purpose 


The SAVE command transfers a copy of the BASIC program currently in memory to a file 
on the disc. The file can be in either binary or ASCII form. A SAVE command will create its 


own file if necessary. 


SYNTAX FORM 


SAV “F.” [string]; [, constant І, constant]] 


DESCRIPTIVE FORM 


SAVE "F.I." [,“А”]; [Line number [beginning, ending line number]] 


Field Definitions (Descriptive Form) 


SAVE 


РА. 


beginning line number 


ending line number 


This is the keyword for the command. It may be entered as 
shown in SYNTAX FORM. 


This Е.І. must be a valid Е.І. (see Section 4). If no file has been 
created, this command will create its own. 


Any F.I. must be in quotes. 

If “А” is entered in this field, the program is sent to storage in 
ASCII form. If no entry is made, the program is stored in host 
binary form. 


"A" must be in quotes. 


If no ending line number is entered, a single line, specified by 
this entry, is saved. 


No entry can be made here unless a beginning line number is 


also entered. The program transfer ends after the statement with 


this line number. 
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COMMAND DESCRIPTIONS 

П SAVE 
П General Information 
П Ф Тһе stored program тау be retrieved with ап APPEND or OLD command. 

€ If speed is important, programs should be saved in binary (default) form. 
П Ф A SAVE command тау not Бе executed to a random file. 
П € A file does not need to be opened to execute а SAVE command. 

e If the file exists prior to this command, the file type (ASCII or binary) must match 
П the type specified in the command. If the file does not exist, a new file of the 

correct type, with the Private attribute and minimum length to store the program, is 
П automatically created. 
Prerequisites 

П Disc must be mounted but device must not be reserved. File does not have to be open. 
o Examples 
П Example 1: 
П 400 SAVE ““@MYLIBRY/STOCKS”; 100,500 

The statements from 100 to 500 of the current program in memory are stored ina file 
П with the F.I. shown. The program is stored in binary format. The resulting Не has the 
! host binary attribute (Н). 
П Ехатріе 2: 

350 SAVE AS$,"A" 

П This example places the entire program in memory into the file that has its Е.І. stored 
n in А$. The program is saved in ASCII format. 
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COMMAND DESCRIPTIONS х 
ЗЕСНЕТ || 


SECRET 


Purpose 


The SECRET command prevents future listing of a binary program. It is executed just 


prior to saving the program to a file. | 


SYNTAX FORM 


SEC || 


DESCRIPTIVE FORM 


p 


SECRET 


Field Definitions (Descriptive Form) V 
SECRET This is the keyword for this command. Entry as shown in SYNTAX 
FORM. 


General Information 


If this command is written to an ASCII program, the program cannot be brought into 
Graphic System memory with an OLD command. ASCII programs with a SECRET 
designation, however, may be appended into memory. 


This command may be executed on a magnetic tape or disc file. 


Prerequisites 


None. 


C 
I. т Е 
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COMMAND DESCRIPTIONS 
CALL “SETTIM” 
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ей 


CALL “SETTIM” (Set Time) 


See Appendix E for information on using 
this command with the Extended Memory 


Purpose File Manager. 


The CALL “SETTIM” command sets the system clock so the exact time and date may be 
recorded when files are created, used or altered. The system clock is also necessary to 
mark the exact time and date on the volume label when discs are formatted. 


Аа 222 


ЗУМТАХ ҒОНМ 


CAL “ЗЕТТИМ”, string 


DESCRIPTIVE FORM 


CALL “SETTIM”, date and time 


J 


a ша ша LJ 


- 


Field Definitions (Descriptive Form) 


CALL "SETTIM" These are the keywords for this command. The entry may be 
made as shown in SYNTAX FORM. 


date and time The format for this field is: 
“DAY-MONTH-YEAR HOUR:MINUTES:SECONDS” 


Except for “month,” which requires three characters, all sub- 
fields in this field may be one or two characters long. 


"DD-MON-Y Y HH:MM:SS” 

For example, if the system clock is to be set at one minute and 
20 seconds past two PM on the fifth of January 1978, the entry 
is written this way: 


"5-JAN-78 14:1:20" 


Note that the "time" subfields are based on the military time 
scale of 000 to 2400 hours and that the entire entry is in quotes. 


2 


The syntax for this range is 0:0:0 to 23:59:59. 
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General Information 


NOTE 
The system clock must be operating whenever the system is being used. 
When the clock has not been set, the clock indicator on the controller front 
panel is lit. The system clock must be set whenever the system is powered 


up. The time entered in the CALL "SETTIM" command must be accurate or 
certain commands such as CALL "RENAME" will not work correctly. 


The "seconds" subfield is optional. All characters entered past the seconds subfield are 
ignored. 
The first three characters of the word for that month must be entered in the month field. 


Entries must be made in both date and time fields. The command cannot enter dates later 
than 2040 A.D. 


The system generates a February 29 on leap years. On non-leap years, a December 32 is 
generated. 
Prerequisites 


None. 


Examples 
CALL'"SETTIM","14-DEC-77 20:30" 


This example sets the system clock at thirty minutes past eight in the evening, 
December 14, 1977. 


САП “5ЕТТІМ”,А% 


This example sets the system clock to whatever date/time specifications are stored 
in AS. 
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CALL “SPACE” 


Purpose 


COMMAND DESCRIPTIONS 
CALL “SPACE” 


The CALL “SPACE” command is used to reduce or increase allocated file space. 


Normally, however, it is used to reduce the allocated space for a file only partially filled so 
that more space is available for other files. Although it may be used to increase a file size 


the system’s dynamic space allocation feature makes this unnecessary. 


SYNTAX FORM 


CAL “SPACE”, numeric expression, numeric expression, numeric variable, 


numeric variable 


DESCRIPTIVE FORM 


CALL “SPACE”, Ifn, requested file size, target numeric variable, 
target numeric variable 


Field Definitions (Descriptive Form) 


CALL “SPACE” 


Ifn 


desired file size 


target numeric variable 


target numeric variable 
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This is the keyword for this command. Entry 
may be made as shown in SYNTAX FORM. 


Logical file number: This entry must match 
the Ifn specified in the OPEN command. 


This entry, in bytes specifies how large the 
file is to be. The actual number of bytes will 
be in increments of 256. 


The amount of data, in bytes, already in the 
file is stored in the variable entered here. 


The actual file size, in bytes, after command 
execution is stored in the variable entered 
here. 
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COMMAND DESCRIPTIONS 
CALL "SPACE" || 


General Information || 
The space available for increasing a file тау be seen by executing a CALL "DSTAT" 

command; this command returns the number of free bytes remaining on a disc. Ц 
If the number of bytes specified in "desired file size" is less than the data required, the 

file will be reduced to just enough to hold the data. || 
Ап easy way to release unused file space on the disc is to execute CALL “SPACE” with 

zero (0) bytes requested. Ц 
Prerequisites | | 


Ейе тив! Бе ореп. 


150 CALL “ЗРАСЕ”, 3,1 000,А,В 


Example | 
L 
J 


This example allocates 1024 bytes to the file associated with № З. The number of О, | 
bytes required by the data already in the file is sent to А. The actual number of bytes 
in the file after command execution is sent to B. || 
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CALL “TIME” 


a. 2 
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CALL “TIME” 


See Appendix E for information on using 


this command with the Extended Memory 
Purpose File Manager. 


The CALL "TIME" command returns the current date and time, according to the 
system clock, to the string variable specified in the last field. 


SYNTAX FORM 


CAL “TIME”, string variable 


DESCRIPTIVE FORM 


ча 


CALL “TIME”, target string variable 


па 


Field Definitions (Descriptive Form) 


J 


CALL “TIME” These are the keywords for this command. 
They may be entered as shown in SYNTAX 
FORM. 

target string variable This is the location to which the 18 charac- 


ter time “message” is sent. 


General Information 


ша шз таз 


If the system clock is not operating, а null string is sent to the return string variable. 


Prerequisites 


A previous execution of CALL “SETTIM” is necessary for an accurate message. 


Example 


CAL "TIME", A$ 


2 


This example sends the current date and time, according to the system clock, to A$. 


Ja I a га 3 
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COMMAND DESCRIPTIONS 


TYP і 
E 
а 
ТҮР (Туре) See Appendix Е for information on using L 
this command with the Extended Memory 
Purpose File Manager. 
( 
ТУР is a function rather than а command and performs іп the same way for disc files as it Li 
does for the magnetic tape files. TYP determines whether the data is in ASCII or binary 
form, and if binary, whether data is numeric or alphanumeric. It also establishes if the file Е 
is empty, open, and whether the end of the data has been reached (EOF character) ог is 
ilegal. 


This function is necessary whenever the type of data is unknown. It returns an integer 
from O to 5, indicating one of the above conditions. See Table 5-1. See TYP in the 4050 
Series Graphic System Reference Manual for details. | 


‘ 
SYNTAX FORM Е 


ТҮР (numeric expression) |! 


DESCRIPTIVE FORM Vf 


ТУРЕ (п) 


Field Definitions (Descriptive Form) || 
ТУРЕ This is the keyword for the function. Enter as shown т the SYNTAX FORM. || 
{ 

Ifn Logical file number: This is the same number specified in the OPEN 
command. | | 
ы 


See ТҮР т the 4050 Series Graphic System Reference Manual for further details. | | 
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COMMAND DESCRIPTIONS 

П ТҮР 
П Table 5-1 
П | DATA TYPE TABLE 
} т 

0 Empty File or File Not Open 
П 1 Pointer is at End of File 
i 2 | Numeric Data or Character String Оайа/АЗСИ Format 

3 Numeric Data/Binary Format 
П 4 | Character String Data/Binary Format 

5 Шеда! Data 
1 If the integer 5 is returned, data is illegal and cannot be read. 
1 Prerequisites 
! 
i File must be open. 
n^ 
I 
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COMMAND DESCRIPTIONS || 
| 


UNIT 
t 
UNIT U 


Purpose | 
The UNIT command specifies the current device. Commands containing F.l.s or Ifns | 
without device addresses аге directed to the current device. If по UNIT command is Li 


executed, the system designates device zero (0) as the current device. 


SYNTAX FORM 


( 
4 
UNI constant |! 


DESCRIPTIVE FORM 


UNIT device address i 


Field Definitions (Descriptive Form) 


UNIT This is the keyword. it may be entered as shown in SYNTAX || 
FORM. 

l 

device address The device address may be seen on or near the front of the | 
device. 


General Information 


The UNIT command must be executed each time the system is powered up, if any device L 
other than О is to be the current device. 
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UNIT 
1 Тһе following commands always attempt to execute on the current device specified by 
the UNIT command: 
| АРРЕМО 
t 
ASSIGN 
1 CALL “NEXT” 
! CALL “REWIND” 
CLOSE 
П СНЕАТЕ 
! DIRECTORY 
INPUT 
1 кіш 
E OLD 
OPEN 
Я PRINT 
READ 
SAVE 
q WRITE 
і 
А If no UNIT command is executed, device zero (0) is considered the current device. 
1 МОТЕ 
! 
The INIT, OLD апа DELALL commands also reset те current device 
address to zero (0). 
1 
Device zero (0) тау ог may not exist, depending on your system. This depends оп the 
q strapping procedures carried out when your system was installed. Your Tektronix service 
person will identify the device addresses after installation. 
Prerequisites 
П Мопе. 
1 Example 
n 110 UNIT 2 
= d \ This example specifies device 2 аз the current device. 
, 
4 
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COMMAND DESCRIPTIONS 
CALL “UNIT” 


CALL "UNIT" 


Purpose 


The CALL “UNIT” command specifies the current device. Commands containing F.l.s or 
Ifns but no device addresses are directed to the current device. If no CALL “UNIT” 
command is executed, the system designates device zero (0) as the current device. 


SYNTAX FORM 


CAL "UNIT", numeric expression 


DESCRIPTIVE FORM 


CALL "UNIT", device address 


NOTE 
This command functions exactly as the UNIT command. The only 


difference is that UNIT requires a constant in the device address field 
where CALL "UNIT" allows a numeric expression. 


Field Definitions (Descriptive Form) 


CALL "UNIT" These are the keywords. They may be entered as shown in 
SYNTAX FORM. 
device address The device address may be seen on or near the front of the 
device. 
\ i 
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COMMAND DESCRIPTIONS 
CALL “UNIT” 


оша 
2 


General Information 


ase | 


The CALL "UNIT" command must be executed each time the system is powered up, if any 
device other than O is to be the current device. 


з 


The following commands always attempt to execute оп the current device specified by 
the CALL “UNIT” command: 


3 


— Á 
adorans 


APPEND 
ASSIGN 
CALL "NEXT" 
CALL "REWIND" 
CLOSE 
CREATE 
DIRECTORY 
INPUT 

KILL 

OLD 

OPEN 

PRINT 

READ 

SAVE 

WRITE 


з 


— 
- 


2) 


| — 2223 
2 


I 


If no CALL "UNIT" command is executed, device zero (0) is considered the current 
device. 


ben 


The INIT, OLD and DELALL commands also reset the current device to zero. 


Device zero (0) may or may not exist, depending on your system. This depends on the 
strapping procedures carried out when your system was installed. 


Z3 з 


Prerequisites 


1 Мопе. 
П Ехатріе 
n 120 CALL“UNIT”,B 
/ \ This example specifies the device whose address is іп В as the current 
T device. 
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CALL “USERLIB” 
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CALL “USERLI B” See Appendix E for information on using 


this command with the Extended Memory 
File Manager. 


Purpose 


The CALL "USERLIB" command specifies the "current library." This command makes 
repeated file access more convenient. 


The CALL “USERLIB” command places a portion of an Е.І. in memory where it may 
automatically be recalled to precede the balance of the Е.1. in subsequent commands. 
This portion is called the current library. 


SYNTAX FORM 


CAL "USERLIB", "string" 


DESCRIPTIVE FORM 


CALL "USERLIB", partia “Е.Л” 


Field Definitions (Descriptive Form) 


CALL "USERLIB" These are the keywords for this command. They may be entered 
as shown in SYNTAX FORM. 


partial Е.І. This entry may match up to the first 21 characters of the F.I. of 
the file to be accessed. А! delimiters, (/), С), О, as well as 


passwords, must be included in the 21 character count. 


Names on only the first four of the five available storage levels 
may be entered in this field. 


If a string variable is entered in this field, it must also represent 
21 characters or less. 
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COMMAND DESCRIPTIONS 
CALL “USERLIB” 


General Information 


A slash is automatically assigned to the end of the partial Е.І. entered in this command. 
Even though it may be considered as a 22nd character, it is accepted by the system. 


The current library specified in a CALL “USERLIB” command may be circumvented by 
preceding an F.i. with a commercial "at" sign (8) or a dollar sign ($). See SPECIAL 
CHARACTERS in Section 4. 

Special characters (@ , #, *, ?) should not be used in a CALL "USERLIB" command. 


INIT, OLD or DELALL commands disable a previous CALL "USERLIB" command. 
These commands automatically specify SCRATCHLIB as the current library. 


If a null string is entered with a CALL "USERLIB" (CALL “USERLIB”,‘“”), then there is no 
current library. 


Prerequisites 


None. 


Examples 
Example 1: 


If your disc just contains files, then the F.l. used to access any file will consist of the 
name of the file only; i.e.: “ТАХ”. However, you must circumvent or disable the 
current library provided by the system. To circumvent this library enter (9) with the 
file name, i.e. "TAX". To disable the current library enter: 
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COMMAND DESCRIPTIONS 
CALL "USERLIB" 


5-110 


Example 2: 

If several 4th level files below the same 3rd level library (PROJ) are to be repeatedly 
accessed, the names of the first three levels may be entered in a CALL "USERLIB" 
command. For example, if the F.I. of one of the files is 


"MYLIBRY/PROG/PROJ/DATA," 


then everything up to the name of the file, except the last slash (/), may be placed in 
a CALL "USERLIB" command in this way: 


110 CALL "USERLIB", "MYLIBRY/PROG/PROJ" 
The only entry repeatedly required in the command accessing the file is "DATA". 
Example 3: 
If many libraries and files under one particular 1st level library are to be accessed, 
only the 1st level library name can be part of a CALL "USERLIB" command. For 
example, if two F.I.’s used in a program look like this: 
"PRODUCER/PRICES/LIST" 


"PRODUCER/SALESMEN/AREA1" 


Then the CALL “USERLIB” command can only contain "PRODUCER" as shown 
below. 


150 CALL "USERLIB","PRODUCER" 
The F.I.’s used throughout the balance of the program must be written like this: 
“PRICES/LIST” 
or this: 


“SALESMEN/AREA1” 
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COMMAND DESCRIPTIONS 
WRITE 


on 


з 


WRITE 


Purpose 


(кені | 


Тһе WRITE command enters binary data into the designated file. It operates like the 4051 
BASIC WRITE command with the following exceptions: 


222 


e The їп (logical file number) specified т the preceding OPEN command must бе 
entered. This МО address tells the system which disc file to access. 


222 


Ф Random as well as sequential files тау be written. This means that, unlike 
magnetic tape files, it is possible to directly access a particular location in the file 
when writing or reading from a file. 


-— 222 


€ The primary address character is “#”. 


Unlike entries in the PRINT command, each string or numeric value in a WRITE command 
is considered a separate entry. 


a 2222 


5 


SYNTAX FORM 


sea 


WRI # constant [numeric expression] : 


string variable string variable 


numeric ah з 22 


223 


DESCRIPTIVE FORM 


2-2 


WRITE #Ifn [record number] : data item [,data item]... 


Field Definitions (Descriptive Form) 


ша 222 


WRITE This is the keyword for this command. The entry may be made as 
shown in SYNTAX FORM. 


# fn Logical file number: The number here must match the Ifn 
specified in the OPEN command. 


2222222 


Е 5 
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COMMAND DESCRIPTIONS | | 
i 
WRITE | B 
YU 
record number An entry is necessary here if you are writing to a random file. Li 
The logical file pointer is placed at the beginning of the record li 
specified. That is where WRITE will begin. When WRITE is 


executed, all subsequent items in THAT RECORD ONLY are 


erased. Li 


No entry is necessary if you are writing to a sequential file. If the 

WRITE is part of a program and is used to enter information in a | 
sequential file one time and а random file another time, а 

variable must be entered. See Example 4. 


data item This is the item to be stored. It may be the actual item (constant), 
a numeric expression, a variable (A, A$, etc.), or a combination. 


A constant must be in quotes. 
у 
data item Same as previous field. | 
General Information 
€ |f you are "updating" a sequential file, that is, adding data to the end of existing 
information, “Ц” must be entered in the previous OPEN command. This places the 
logical file pointer at the end of the last item. WRITE then adds data beginning at 
the pointer location. 
5 
® For programming examples see USING WRITE AND READ IN A PROGRAM | 
(Аррепах С). 


Writing Data “т Between” In Sequential Files. As we һауе described, the logical file 


pointer in sequential files is always placed at the beginning of the file or at the end of the 4 
last item (with “U” in the OPEN command). There are times, however, when it may be L 
necessary to WRITE data at a point between the first and last items. This means 

alternating TYP functions! and READ commands must be executed. This will move the | 
pointer item by item until it is at the desired location. WRITE may then be executed. L 


Remember that ali existing items past that point to the end of the file will be erased. 


This procedure is not possible with random files because each WRITE command returns || 
the logical file pointer to the beginning of the record. See READ command description for 
examples of how to retrieve information written to a file. 


1 TYP functions are necessary only if the type of data item (a string or number) is unknown. \ j 


\ 
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COMMAND DESCRIPTIONS 


WRITE 

Prerequisites 
Disc must be mounted but device must not be reserved. File must be open and in binary 
format. 
Examples 

Example 1: WRITING STRINGS AND A NUMERIC VALUE TO A SEQUENTIAL 

FILE 
150 WRITE #3:“ТОМ”, “241 MAIN, MILL СІТҮ”,5464451 

This example stores “ТОМ”, “241 MAIN, MILL CITY” and 5464451 as three separate 

items: a String, a string, and a numeric value. 

Remember, any number within quotes is not considered a numeric value but part of a 

string. The WRITE command starts the at current pointer position. After the WRITE 

command is executed, the pointer is located at the end of the third item. 

string string numeric 
Нет | ТОМ | item |241 MAIN, MILL CITY | item {5464451 
header header header 
BEGINNING POINTER POSITION ENDING 
POINTER 
POSITION 

Another WRITE command may be executed to add more strings. The new information 

is recorded starting where the logical pointer is located. If the file is closed first and 

then reopened, the next WRITE command places the new data at the beginning of 

the file. The OPEN command must contain “U”, which will start WRITE at the end of 

the existing data. 

Example 2: WRITING STRINGS AND A NUMERIC VALUE TO A SEQUENTIAL 

FILE 
160 WRITE #3: A$, B$, C 

This example functions exactly as Example 2 if: 

A$ = “TOM” 

В$ = “241 MAIN, MILL CITY” 

C = 5464451 
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WRITE 
NOTE 
ASCII random access files must be initialized. That is, each record in the 
files must be completely filled before the next record can be accessed. A 
quick routine to do this is shown on page B-2 of this manual. 
Example 3: WRITING STRINGS AND A NUMERIC VALUE TO A RANDOM FILE 
340 WRITE #3, 40: “GRANT, ТОМ”, “GEOL”, 2.5 
This example stores “GRANT”, “TOM”, “GEOL”, and 2.5 as three separate items: a 


string, a string, and a number. The items are placed at the very beginning of record 
40 in Ш З. 


record | string string numeric _ N bytes 
#40 Нет | GRANT, ТОМ | item |СЕОЁ | item | 2.5 remaining т 
boundary | header header header record 


BEGINNING POINTER POSITION ENDING 
POINTER 


POSITION 


The logical pointer is now located at the end of the third item. 


NOTE 
If the record is too short for the binary information to be entered, an error 


message appears. 


If another WRITE command is executed to this record, the logical file pointer will 
move back, and the new information will be placed at the beginning of record 40. 


If information exceeds the remaining record space, an error message will appear. If it 


is less, the gap between the last item and the next record boundary will be ignored. 


Example 4: |. WRITING TO A RANDOM OR SEQUENTIAL FILE 


260 WRITE ЯЗ,А:“ТОМ”,61,2.45 
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П COMMAND DESCRIPTIONS 
WRITE 
DES This example writes the items "TOM", 61, 2.45 to Ifn 3. If the value of A is zero (0), 
n the system assumes the file is sequential. If the value of A is 1 or greater, it assumes 
the file is random and starts writing at the record with that number. 
П Example 5: WRITING A SINGLE STRING TO А RANDOM FILE 
n 110 WRITE #3,20:“SMITH, 2.51" 
This example writes a single string item to the beginning of record 20 in Ifn 3. 
n^ 
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ROUTINE MAINTENANCE 
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ROUTINE MAINTENANCE 


The following servicing instructions are for use by qualified personnel 
only. To avoid personal injury, do not perform any servicing other than that 
contained in operating instructions unless you are qualified to do so. 


The table below shows routine maintenance for the flexible disc drives. Procedures 1 and 
2 may be performed by the operator. Procedures 3 through 6 should be carried out by a 
Tektronix serviceman and are fully described in the Flexible Disc Drive Service Manual. 


Action 
Procedure Required 


1 Read/write Oxide build- 12 months Clean read/write 
head up resulting head. 
in repeated 
hard or soft 
errors 
head 
3 Stepper motor | Nicks, 12 months Clean off oil, dust, 
and lead burrs, and and dirt. Dress 
screw dirt down nicks or 
burrs, or replace 
part. 
4 Frayed or 12 months Replace. 
weak ar- 
eas 
5 Base Loose screws, | 12 months Tighten screws, 
switches, connectors, and 
and switches. 
connec- 
tors 
Check for Clean off dust and 
dust and dirt. 
dirt 
6 Read/write Aborted I/O 12 months Align head. 
head commands 
or distorted 
results 
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Ргоседиге Мо. 1 


High voltages inside сап cause death on contact. Unplug line before 
removing cover on drive. 


a. Remove cover from drive (Figure 6-1). 


Figure 6-1. Removing 4907 Main Cabinet Cover. 
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b. Remove oxide from head with swab апа alcohol (Figure 6-2). 


ROUTINE MAINTENANCE 


Figure 6-2. Cleaning Read/Write Head. 


c. Replace drive cover. 
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Procedure No. 2 


High voltages inside can cause death on contact. Unplug line before 
removing cover from drive. 


a. Remove cover from drive (Figure 6-3). 


2380-44 


— 
Figure 6-3. Removing 4907 Main Cabinet Cover. 


6-4 REV, OCT 1982 4907 & EXTENDED MEMORY OPERATOR'S 


э 


НОМТІМЕ МАІМТЕМАМСЕ 


b. Remove read/write head button (Figure 6-4). 


Figure 6-4. Removing Read/Write Head Button. 


c. Install new read/write head button (Figure 6-5). 


Figure 6-5. Installing New Read/Write Head Button. 
d. Replace drive cover. 
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Section 7 


SPECIFICATIONS 


4907 PERFORMANCE SPECIFICATIONS 


1. Data File Storage Capacity (formatted and accessible by operator) 


Per Drive (includes 


256-byte directory) 630,528 bytes 
Per Track 8192 bytes 
Per Sector 256 bytes 


2. GPIB Data Transfer Rate 


Burst 3900 bytes/sec 
Sustained 1300 bytes/sec 


3. Error Rate 


Refer to FLEXIBLE DISC DRIVE SPECIFICATIONS. 


4907 PHYSICAL SPECIFICATIONS 


1. Dimensions 

Height 

Width 

Depth (minus drive door handle projection) 
2. Weight 

Main Unit 


Auxiliary Unit of Option 30 
Auxiliary Unit of Option 31 
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7.94 in (20.17 cm) 
20.31 in (51.59 cm) 
25.25in (64.14 cm) 


51 Ibs (23.1 kg) 
50 Ibs (22.6 kg) 
62 Ibs (28.1 kg) 
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4907 ENVIRONMENTAL SPECIFICATIONS 


1. Operating Environment 


Ambient Temperature 


Relative Humidity 
Maximum Wet Bulb 


Maximum Altitude Above Sea Level 


2. Storage Environment 


Ambient Temperature 


Relative Humidity 


Maximum Altitude Above Sea Level 
Shipping Temperature 


3. Shock (nonoperating) 


50° Е to 
100°Е 

(10°C to 38° C) 
20% 10 80% 

78° (25% С) 
10,000 ft (3048 т) 


50%Ғ10125%Ғ 

(10° C to 52° C) 

8% to 80% 

50,000 # (15,240 т) 
—40°F to 125°Е 


(—40* C to 52° C) 


Unit will not suffer damage or fail to operate when subjected to three impact shocks of 
approximately 20 g's in each direction along each main axis. Shock time is 11 = 1 ms. 


4. Vibration 


Unit wil! not suffer damage or fail to operate when subjected to the following vibration 
for a period of 5 minutes along each main axis. 


Nonoperating 5 to 25 Hz at 0.008 in displacement 
25 to 55 Hz at 0.004 in displacement 
5 to 25 Hz at 0.0014 in displacement 
25 to 55 Hz at 0.0007 in displacement 


Operating 
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4907 ELECTRICAL SPECIFICATIONS 


1. AC Power Supply Requirements 


A rear panel line voltage selector matches the transformer inputs to four different line 
voltages. 50 Hz systems can be used by changing the pulley and belt in the disc drives. 


Table 7-1 shows the allowable line voltages: 


Table 7-1 


LINE VOLTAGES 


SPECIFICATIONS 


Line 
Voltage Tolerance Frequency кор 
100 Мас 90-110 2 A Med Blow 
120 Vac 108-132 50 or 60 Hz 2 A Med Blow 
220 Vac 198-242 + 5 Hz 1 A Med Blow 
240 Vac 216-264 1 A Med Blow 


2. Maximum power dissipation at 120 Vac, 60 Hz, is 140 W. 


3. Maximum load current at 120 Vac, 60 Hz, is 1.7 A. 


FLEXIBLE DISC DRIVE SPECIFICATIONS 


1. Type 


Rackmount Flexible Disc Drive, with hard sector (32), write-protect hole detect, and 


double-density recording. 


2. Performance Specifications 


Capacity (unformatted) 
Per Disk 
Per Track 
Transfer Rate 
Latency (average) 
Access Time 
Track to Track 
Average 
Settling Time 
Head Load Time 
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megabits 
kilobits 


kilobits/sec 


ms 


ms 
ms 
ms 
ms 
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3. Physical Specifications 


Error Rates 
Soft Read Errors 
Hard Read Errors 
Seek Errors 


4. Environmental Specifications 


1 рег 109 bits read 
1 per 1012 bits read 
1 per 106 seek 
operations 


Same as 4907 ENVIRONMENTAL SPECIFICATIONS. 


MEDIA REQUIREMENTS 


1. Type 


2. Storage Environment 
Temperature 
Humidity 

3. Media Lifetime 


Passes per track 
Insertions 
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Double-density 
compatible 


40° F to 140° F 
(5° C to 60° С) 
8% to 80% 


3.5 x 10E5 
>30,000 
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ROM PACK SPECIFICATIONS 


1. Dimensions 


Length 4.66 in (11.836 cm) 

Width 2.62 in (6.655 cm) 

Depth 0.88 in (2.235 cm) 
2. Weight 8 oz (227 gm) 


3. Environmental Requirements 
Same as 4907 ENVIRONMENTAL SPECIFICATIONS. 
4. Power Requirements (from Graphics System) 


+5 Vde 300 mA 
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MESSAGES Page 
Device and File Status Меѕѕадеѕ. ........................... A-1 
File Status Messages .................................... A-1 
Device Status Messages ................................. A-4 
Error Messages and Recovery Ргосейигеѕ................... A-6 
Command Ехатріев........................................ A-15 
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MESSAGES 


DEVICE AND FILE STATUS MESSAGES 


File Status Messages 


File status messages are generated by CALL “FILE”, DIRECTORY, and CALL “DSTAT” 
commands. The messages are stored in a string variable specified in the command. The 
messages generated by DIRECTORY may be displayed on the screen, printed, or stored 
on tape. 


а a 


—1 


A complete or “full” file status message has the following format: 


n BRS N ATR NNNNNNN ALLOC DD-MON-YY HH:MM ALT 
NNNNNNN USED DD-MON-YY HH:MM USED 
N OPEN NNNNNN ВЕС LEN DD-MON-YY НН:ММ CREATED 
^^ FILE IDENTIFIER 


=. 


Field Descriptions 


DD-MON-YY HH:MM ALT 
П DD-MON-YY HH:MM USED 
DD-MON-YY HH:MM CRE 
П These fields show the day of the month, year, hour and minute the Ше was LAST 
ALTERED, LAST USED, and CREATED. If the system clock was not set, the fields look like 
n this: 
| “00-ХХХ-00 00:00” 
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The following table shows which fields аге updated when the commands listed аге 


executed. 
Fields Last Altered Last Used Created 
Commands CREATE CREATE CREATE 
COPY TO COPY TO SAVE (old 
(new file only) (both files) file only) 
CALL "DUP" CALL “DUP” (both 
(new file only) files) 
SAVE (both files) SAVE (both files) 
WRITE (updated CLOSE 
when file is ASSIGN 
closed) 
PRINT (updated APPEND 
when file is 
closed) 
CALL "SPACE" CALL "RENAME" 
CLOSE (only if 
opened “F” se- 


BRS N ATR 


NNNNNNN ALLOC 


NNNNNNN USED 


N OPEN 


NNNNN REC LEN 


quential) 


Denotes the file attributes, either as specified in the 
CREATE command, or altered by the ASSIGN com- 
mand. If a C follows the S in the attribute field, it 
means that although the file was specified “scat- 
tered,” the file was created contiguously because 
plenty of room was available. 


Shows the number of bytes allocated to the file. 


Shows the number of bytes actually used for 
storage. 


Shows the number of current OPENs on this 
particular file. With single host systems this will 
always be 1. 


Shows the number of bytes allocated to each record 
in a random access file. Shows zero (О) for a 
sequential file. 
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MESSAGES 
FILE IDENTIFIER Shows the name of the file. This field will appear in 
the first line of the message if a DIRECTORY was 
executed. 
Example 
MYLIBRY/TOM/PERSONAL 9984 ALLOC 01-DEC-77 12:30 ALT 
BUS N ATR 6000 USED 01-DEC-77 08:10 USED 
1 OPEN 60 REC LEN 01-DEC-77 08:10 CRE- 
ATED 


This message would appear after executing a DIRECTORY command for a file created at 
8:10 AM, last altered at 12:30 PM, with all activity taking place Dec. 1, 1977. Currently 
there is only one OPEN. The file was allocated 9,984 bytes of space, of which 6000 
contain information. The records in the file are 60 bytes long. "BUS М АТВ” indicates the 
file contains binary, public and scattered but non-compressible, information. The Е.І. 
indicates the name of the file is "PERSONAL" and is contained under libraries “ТОМ” and 
"MYLIBRY." 


General Information 


The DIRECTORY command allows the user to generate file status messages with three 
levels of information: 


The first level includes the F.I. only. 


The second level includes the Е.І. and when the file was created, last used and last 
altered. 


The third level includes the F.I., attributes, space specifications, and when the file 
was created, last used and last altered. 
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Device Status Messages 


The device status messages are generated by the CALL “ОЗТАТ”, CALL “CUSTAT”, and 
CALL “MOUNT” commands and are stored in the specified string variable. The message 


format is shown below: 


NN UNIT 


XXXXXXXXXXXX DEV ID XXXXXXXXXX VOL ID ХХХХХХХХХХХХХХХХХХХХХХХХ 
OWNER NNNNNNNNN FREE NNNNNNNNN SIZE NNNNNNNNN LOST NNNNN BLK SIZE 
DD-MMM-Y Y HH:MM FORMATTED NNNNN FILES OPEN RESERVED WRITE PRO- 


TECTED 


Field Descriptions 


NN UNIT 


XXXXXXXXXXXX DEV ID 


XXXXXXXXXX VOL ID 


XXXXXXXXXXXXXXXXXXXXXXXX. OWNER 


NNNNNNNNN FREE 


NNNNNNNNN SIZE 


NNNNNNNNN LOST 


NNNNN BLK SIZE 


DD-MMM-Y Y HH:MM FORMATTED 


NNNNN FILES OPEN 
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Shows the device address. This field ap- 
pears only when CALL “СУЗТАТ” is exe- 
cuted. 


Shows the nomenclature of the device. 


Indicates the name of the disc as specified 
in the CALL "FORMAT" command. 


Indicates the owner's or user's name as 
specified in the CALL "FORMAT" command. 


Indicates the number of usable non-file 
bytes remaining on disc. 


Shows the number of storage bytes provided 
by this type of disc. 


The number of bytes that the processor does 
not have room to keep track of. If more than 
zero, the disc needs to be compressed. 
indicates the size of each principal block in 
bytes. 


Indicates the day of the month, month, year, 
hour and minute the disc was formatted. 


Shows the number of files currently open. 


4907 & EXTENDED MEMORY OPERATOR'S 


C 


г. г ES 


C 


[D о. Е Lo зе 


C 


поно A са 2а 


2 


ж 


МЕ55АСЕ5 

RESERVED Appears only if device is reserved. 
WRITE PROTECTED Appears if device or disc is write-protected. 
Example 
01 UNIT 
490? DEY ID COMPANY UOL ID YOUR NAME OWNER 

539528 FREE 638784 SIZE 0 LOST 256 BLK SIZE 
24-АЦ6-78 09:48 FORMATTED 9 FILES OPEN RESERVED 


This message would be generated for device 1, which is identified as a 4907. The disc is 
identified as "COMPANY" and the owner as "YOUR NAME.” There аге 630,528 bytes of 
usable non-file space. The 630,784-size field indicates this is a flexible disc with no 
bytes of unusable or damaged space. The block size is 256 bytes. 


The disc was last formatted on August 24, 1978 at 9:48 AM. № disc files are open and 
the device is reserved but not write-protected. 


The 01 unit will only appear when CALL "CUSTAT" is executed. 
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ERROR MESSAGES AND RECOVERY PROCEDURES 


(*Asterisks indicate that additional information will be displayed, further defining the 


error.) 


Error Message 


Cause 


Correction 


ERROR 1 
BUS I/O ERROR* 


GPIB data transfer 
error often caused 
by static electricity. 


Execute an INIT then 
reissue command. If this 
is not successful, re- 
starting program may be 
песеззагу. 


ERROR 2 
ILLEGAL COMMAND 


4907 or Graphic 
System error. 


This message may also 
appear during a WRITE 
command if a device 1/0 
error has occurred. If so, 
be sure the 4907 has 
been loaded and is oper- 
ating correctly. If error 
message repeats, see 
4907 File Manager Ser- 
vice Manual. 


ERROR 3 
COMMAND FORMAT 


4907 or Graphic System 


error. 
See 4907 File Manager 
Service Manual. 


ERROR 4 
ILLEGAL COMMAND FIELDS 


One or more entries 
in the CALL "FOR- 
MAT” or CALL 
“FFRMT” com- 
mands are illegal: 
volume number en- 
try is not 1, number 
of volumes entry is 
not 1, number of di- 
rectory chains is 0 
or greater than 10. 


REV, OCT 1982 


| 


Execute command again 
with correct entries. 


4907 & EXTENDED MEMORY OPERATOR'S 


Е. 


С 
f° (2 Es: : 


C 
ЕЕ Е 


20 


2 


2 


МЕ55АСЕ5 


Error Message 


ra 


Correction 


ERROR 5 
ILLEGAL MASTER PASSWORD 


m — 


4- Cause 


An attempt has 
been made to exe- 
cute a command 
containing an ille- 
gal entry in the 
master password 
field. 


Master password field 
can contain no more 
than 10 characters. The 
first character must be 
alphabetic and the rest 
alphanumeric. No 
spaces may be entered 
between characters. 


ERROR 7 
ILLEGAL FILE IDENTIFIER 


An Рі. has incorrect 
construction or ille- 
gal characters. 


See FILE IDENTIFIER 
CONSTRUCTION in 
Section 4. 


ERROR 8 
ILLEGAL VOLUME IDENTIFIER 


The volume 1.0. 
field in a formatting 
command has ille- 
gal characters, in- 
correctly located 
Spaces, or is blank. 


ERROR 10 
DEVICE NOT FOUND 


ERROR 11 
DEVICE WRITE PROTECTED 


The system cannot 
find the device with 
the address speci- 
fied in the com- 
mand. 


The volume 1.0. field can 
contain no more than 10 
characters. The first 
character must be al- 
phabetic. No spaces 
may be entered between 
characters. The field 


cannot be blank. 


Re-execute command 
with correct address. If 
this message appears 
the first time the system 
is used, the adjustable 
strapping in the con- 
troller may have been 
positioned incorrectly. 
See 4907 Installation 
Guide. 


An attempt was 
made to write to a 
disc that is write- 
protected. 


Be sure the device 
should be written to, and 
then turn off the write 
protect switch for the 
device. Be sure the 
write-protect tape is 
covering the write-pro- 
tect hole on the disc. 
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MESSAGES 


ERROR 12 
DEVICE RESERVED 


Error Message 


Cause Correction 


Release the device with 


a CALL “DREL” com- 
mand and continue. 


The device was re- 
served and а com- 
mand requiring a 
free device was at- 
tempted. 


ERROR 13 
DEVICE NOT RESERVED 


ERROR 14 
DEVICE HAS FILES OPEN 


Execute a CALL “DRES” 
command and continue. 


The device was not 
reserved anda 
command requiring 
a reserved device 
was attempted. 


Close all files on that 
device and continue. 


A CALL “DRES” 
command was is- 
sued to a device 


with open files. 


ERROR 15 
DEVICE I/O ERROR 


A hard error has See CALL "HERRS" 
occurred on a dev- command description in 
ice. Section 5. If a particular 
location on a disc is 
causing repeated errors, 
it may be taken out of 
use with a CALL 
"MRKBBG" command. 
See 4907 File Manager 
Service Manual for com- 
plete details. 


ERROR 16 
DEVICE NOT READY* 


Make sure address is 
correct, that the disc is 
properly loaded, and that 
the device is up to 
speed. 


| mis message ap- 
pears if: 1. The disc 
is not in place. 2. 
The disc has been 
loaded improperly. 
3. The door has not 
been closed. 4. The 
device is not up to 
speed. 


ERROR 17 
DEVICE NOT MOUNTED* 


An attempt was Execute a CALL 


made to use an un- "MOUNT" command and 
mounted disc. continue 
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Error Message 


Cause 


Correction 


ERROR 18 
NO SPACE* 


There is not enough 
space left on the 
disc for further 
storage. 


Delete any unneeded 
files (KILL), gather the 
remaining free space in 
a single area with the 
CALL "COMPRS" com- 
mand. 


ERROR 20 
CONTROL UNIT ERROR TABLE 
SPACE EXHAUSTED 


ERROR 22 
CONTROL UNIT PROCESSOR ER- 
ROR RAM FAILED 


A command requir- 
ing space equiva- 
lent to two files was 
attempted with ei- 
ther 8 or 9 files 
already open. This 
eliminates room 
necessary for exe- 
cution of the com- 
mand. 


A hardware failure 
in the controller 
prevents further 
System use. 


| Close two files and reis- 


sue the command. 


See 4907 File Manager 
Service Manual. 


ERROR 23 
CLOCK NOT READY 


The system is not 
operating. 


Execute a CALL "SET- 
TIM" command 


ERROR 30 
VOLUME LABEL DAMAGED 


— 


This message ap- 
pears if: 1. The disc 
is damaged. 2. The 
disc was not creat- 
ed by a 4907. 3. 
The disc was re- 
moved during a 
format. 


Execute CALL “DUP”, 
then reattempt CALL 
“MOUNT” on new disc. 
Or format the disc com- 
pletely. Information may 
be unrecoverable оп а 
disc generating this 
message. 


ERROR 32 
DIRECTORY CHAIN DAMAGE* 


This may occur 
when attempting a 
CALL "MOUNT" 
command. 


Execute CALL “DUP”. 
Then reattempt CALL 
“MOUNT” on new disc. 
Information may be 
unrecoverable on a disc 
generating this massage. 
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Error Message 


Cause 


| Correction 


ERROR 34 
DATA AREA DAMAGE* 


ERROR 35 
BLOCK USAGE CONFLICT 


This results from 
damaged or bad 
blocks on a disc. 


Copy the file to another 
disc or to another area 
on the same disc. Then: 


1. Kill old file. 

2. Reserve device 
(CALL "DRES"). 

3. Execute CALL 
"MRKBBG". 

4. Release device 
(CALL “DREL”). 


The system has in- 
correctly assigned 
a physical block to 
two of these three 
categories: 

1. Directory use. 
2. Data use. 

3. Bad block 
group. 

Since no block can 
be assigned to 
more than one use 
at a time or overlap 
an adjacent block, 
this error message 
appears. 


Execute a CALL "DUP" 
command. 


ERROR 40 
LOGICAL FILE NUMBER NOT 
FOUND* 


A command execu- 
tion has been at- 
tempted specifying 
a logical file num- 
ber that does not 
exist. This occurs 
when the Ifn in a 
command does not 
match the Ifn speci- 
fied in an earilier 
OPEN command. 


Execute an OPEN com- 
mand with the correct 
Мп. 


А-10 
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MESSAGES 


Correction 


ERROR 41 
ACTIVE LOGICAL FILE NUM- 
BER* 


- Саиве 


Ап ОРЕМ ог ОРЕМ 
“О” command 
specifying an illegal 
lfn has been is- 
sued. This lfn has 
already been as- 
signed to a file 
which is currently 
active. 


ERROR 42 
FILE NOT FOUND* 


Execute another OPEN 
command with an 
unused lfn, or close old 
file. 


The device involved 
does not contain а 
file with the speci- 
fied name. 


Be sure the device ad- 
dress and the F.l. are 
correct and reissue the 
command. 


ERROR 43 
DUPLICATE FILE IDENTIFIER* 


ERROR 44 
LIBRARY NAME CONFLICT 


An attempt was 
made to create a 
new file with an F.I. 
belonging to an ex- 
isting file. 


A file cannot be 
created at any level 
where there is al- 
ready a library of 
the same name. 


Use a different Е.І. in the 
CREATE command. 


"л. ОТ LLL ‚о ww c —!À————  — кек _——= 


Change the name of the 
file and reissue the 
CREATE command. 


ERROR 45 
FILE LOCKED* 


An attempt was 
made to open a file 
without using the 
passwords speci- 
fied in the CREATE 
command. 


Reissue the OPEN com- 
mand using the correct 
passwords. 


ERROR 50 
FILE IS WRITE PROTECTED* 


An attempt was 
made to WRITE to a 
file opened for read 
access only. 


If you do wish to write to 
the file, close it and then 
reopen it for "full" ac- 
cess. 
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MESSAGES 
Error Message Cause Correction МЈ || 
ERROR 51 А GPIB OPEN com- This message appears 


FILE 15 RESERVED* 


mand was issued 
without setting the 
“wait if file re- 
served” bit. 


when faulty commands 
not involving the ROM 

pack have been issued. 
See 4907 File Manager 


" 


ERROR 52 
ILLEGAL FILE OPERATION* 


An attempt was 
made to perform an 
illegal file opera- 
tion. 


Service Manual. 


Review commands in- 
volved in carrying out 
the operation to be sure 
they are valid for the file 
or information being ac- 
cessed. 


ERROR 53 
END OF FILE* 


An attempt has 
been made to read 
past the end of a 
file. 


This message does not 
appear if an ON EOF 
command is used. 


—————————— P — 


ERROR 54 
ILLEGAL FILE EXPANSION* 


An attempt has 
been made to write 
additional data to a 
noncontiguous lo- 
cation on the disc 
for a file specified 
"contiguous." 


The attribute C (contigu- 
ous) may be changed to 
S (scattered) using the 
ASSIGN command. 


ERROR 55 
NO SPACE* 


There is not enough 
uncommitted space 
left on the disc for 
further storage. 


Delete any unneeded 
files (KILL), and gather 
the remaining free space 
in a single area with the 
CALL “COMPRS” com- 
mand. І/О command may 
then be reissued. 


ERROR 56 
POINTER NOT AT ITEM BOUND- 
ARY* 


This message re- 
sults from improper 
system operation. 


as es 
See 4907 File Manager- 
Service Manual. 
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MESSAGES 


Correction 


ERROR 57 
ILLEGAL ITEM HEADER* 


has encountered an 
illegal item header 
for a standard item 
file. 


The TYPE function 


See TYP command de- 
scription in Section 5. 


ERROR 60 
FORMAT РАШЕО* 


If the CALL "FOR- 
MAT" command 
was issued, it has 
failed because the 
disc has too many 
bad blocks or the 
first block contain- 
ing the volume la- 
bel is bad. 


If the CALL 
“FFRMT” command 
was issued, it may 
have failed be- 
cause the old vol- 
ume label was ille- 
gible due to dam- 


age. 
ERROR 61 The CALL 
MARK BAD BLOCK GROUP “МАКВВС” com- 


FAILED* 


mand failed be- 
cause the bad 
block table in the 
volume label is too 
full or hardware er- 
rors are involved. 


- 


М message appears after 
attempting a complete, 
accurate “full” format, 
choose another disc. 


Copy files to a new disc 
or refer to 4907 File 
Manager Service 
Manual. 


ERROR 62 
ILLEGAL ATTRIBUTE CHANGE* 


The ASSIGN com- 
mand contains at- 
tribute entries 
which conflict with 
the existing file 
type. 


Reissue the ASSIGN 
command with correct 
attribute entries. 
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Error Message 


Cause 


Correction 


ERROR 63 
ILLEGAL IPL FILE* 


The file name ex- 
tension is not valid 
or the file is nota 
host binary type. 


ERROR 70 


COPY SKIPS LOCKED FILE* 


--- 
А COPY ... TO 


command without 
correct passwords 
was issued to a 


Reissue the command 
with the correct exten- 
sion construction. 


Reissue the COPY... 
TO command using the 
correct passwords. If the 
РІ. uses special charac- 


locked file. ters to copy multiple 
files, copying will con- 
tinue with the next file. 
ERROR 71 A COPY ... TO If you wish to copy this 


COPY SKIPS OPEN FILE* 


command was at- 
tempted on an open 
file. 


file to another location, it 
must first be closed. If 
the F.I. in the command 
uses special characters 
to copy multiple files, 
copying will continue 
with the next file. 


ERROR 74 


DELETE SKIPS LOCKED FILE* 


A KILL command 
was issued to a 
locked file. 


Reissue the KILL com- 
mand. If you wish to de- 
lete files with pass- 
words, those passwords 
must be entered in the 
Р.І. or the master pass- 
word must be used. If 
the specific passwords 
or the master pasword is 
not used, the locked files 
cannot be deleted. 


ERROR 75 


DELETE SKIPS OPEN FILE* 


A KILL command 
was attempted on 
an open file. 


If you do intend to delete 
this file, close it and then 
reissue the KILL com- 
mand. 
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MESSAGES 


Error Message 


m 


Cause Correction 


—- 


ЕННОН 78 
RENAME SKIPS LOCKED FILE* 


A CALL “RENAME” 
command without 
correct passwords 
was attempted ona 
locked file. 


Reissue the CALL "RE- 
NAME” command with 
the correct passwords. 


COMMAND EXAMPLES 


Command 


Example 


Result 


APPEND 
А”:1150,15 


АРР“@ MYLIBRY/ 


Takes the entire program іп Ше "A" т 
“MYLIBRY” and places it in memory 
starting with line 1150 of the current 
program. Line numbers are to be in 
increments of 15. The “@” suppresses 
the current library allowing the system 
to access MYLIBRY. 


ASSIGN 


А55“ @ YOURLIBRY/ 
MATH/STAT”;“R” 


Changes the “STAT” file under libraries 
YOURLIBRY/MATH to a private status. 


CALL "COMPRS" 


CAL"COMPRS",1,1 


Collects space in files on device 1 not 
containing information as well as non- 
file space and groups it into larger 
contiguous blocks. 


Closes all files. 


Copies file “ТОМ” from device 1 to 
device 2. If " MYLIBRY" and “FRED” do 
not exist on device 2, they are automat- 
ically created. 


(Compress) 
CLOSE CLO 
mI 

COPY ...TO COP" e YOURLIB/ 
FRED/TOM',1 TO 
“© MYLIBRY/FRED/ 
ТОМ”,2 

СВЕАТЕ CRE“@MYLIBRY/ 


ПАТА”,“А”:100,70 


Creates the file “DATA” on the library 
“MYLIBRY.” The information is to be 
stored in ASCII т 100 records of 70 
bytes each. 
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Command 


Example Result 


CALL “CUSTAT” 
(Controller Unit 
Status) 


CAL"CUSTAT",AS$ Generates a status message for all 
devices interfaced to the controller and 
stores the message in the specified 


string variable. 


DIRECTORY 


CALL “DISMOUNT” 


CALL "DREL" (Dev- 
ice Release) 


CALL “DRES” 
(Device Reserve) 


CALL "DSTAT" 
(Device Status) 


DIR2,“@ MYLIBRY/ 
GRADES" 


Locates the file “GRADES” in library 
"MYLIBRY'", generates a "full" file sta- 
tus message, and displays it on the 
Graphic System screen. 2 indicates the 
format code. 


CAL“DISMOUNT” 1 Deactivates device 1. Prevents system 
use of device until another CALL 


“MOUNT” is executed. 


CAL“DREL”,2 Releases exclusive control of device 2. 


CAL"DRES",2 Reserves device 2. 


CAL“DSTAT”,2,A$ Generates a device status message 
about device 2, as well as a status 
message on all open files. This mes- 


sage is stored in A$. 


CALL "DUP" CAL“DUP”,1,2,1 Duplicates all information from device 1 
(Duplicate) to device 2. All space, including unused 
file space, is collected into a contigu- 
ous space. 
CALL “РЕВМТ” CAL‘“FFRMT”,1, Operates same as CALL “FORMAT” 
(Fast Format) “LAB”, 1,1, except no surface analysis is per- 
“GENETICS”, formed. This command is mainly for 


“ВЕЧЕ”, 7,7,3,3,3 reformatting discs quickly. 


CALL "FILE" 


CAL"FILE",2 
" MYLIBRY/MATH", 
А$ 


Generates file status message about 
file “MATH” in library "MYLIBRY" оп 
device 2. Message is stored in A$. 
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CALL “FMVALS” 
(File Manager Val- 
ues) 


CALL "FORMAT" 


CALL “НЕНН5” 
(Hard Error Status) 


MESSAGES 


Result 


CAL"FMVALS", А,А% 


CAL“FORMAT”,1, 
“LAB”,1,1, 
“GENETICS”, 
“BLUE” ,7,7,3,3,3 


CAL"HERRS", 
1,A,B,C,D 


Sends the current device address to A 
and the name of the current library to 
А$. 


Formats а disc and creates а volume 
label with the following information: 
device address: 1 

volume identification: LAB 

volume number: 1 

number in series: 1 

owner's name or ID: GENETICS 
master password: BLUE 

1st through 5th level chains: 7,7,3,3,3 


Also conducts surface analysis and 
locates and records unusable space on 
the disc. This command is mandatory 
on new discs. 


Requests a count of the last МО retries, 
the total I/O retries since last power up, 
number of successful recoveries, and 
number of unsuccessful recoveries. 
These all refer to device 1. 


All numbers generated are stored in 
variables A, B, C and D, respectively. 


INPUT 


INP #3,40:A$ 


Reads the АЗСИ string in record 40 in 
Ifn З and stores it in A$. 


KILL 


CALL “MOUNT” 


KIL“@ MYLIBRY #” 


CAL“MOUNT”,1,A$ 


Deletes all closed files іп "MYLIBRY." 


Activates device 1 for system use and 
generates device status message. Mes- 
sage is stored in AS. 
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Example 


Result 


CALL “МАКВВС” 


(Mark Bad Block 
Group) 


CAL"MRKBBG",2, 
"COLL',"SECRET', 
“010001ҒҮА” 


This command is executed only after a 
message specifying defective disc ar- 
eas appears. The command identifies 
the volume I.D. as "COLL" with a master 
password of "SECRET" on device 2. 
The address of the defective area is 
“010001ҒА.” 


CALL “NEXT” 


СА “МЕХТ”,З,А$ 


Closes the current file and opens the 
next file in a series specified by an 
OPEN “С” (group) command. This com- 
mand assigns the Ifn З to each file (in 
the group of files) as it is opened. 


OLD 


OLD" S$FINREC/ 
DEPTB" 


CALL "NEXT" generates a new file 
status message with each new file, 
which is stored in AS. If AS is returned 
“” as a null string, then no files remain 
in group. 


Locates the program file "DEPTB" in 
“SYSLIB/FINREC” and reads it from 
disc to Graphic System memory. 


ON EOF 


ON EOF(2)THEN 165 


When end of file is encountered in the 
file represented by Ifn 2, system exe- 
cutes line 165. 


OPEN 


OPE" QG UNIV/MAINT- 
REC" ;1,"U", A$ 


Opens the file “МАШМТВЕС” in library 
"UNIV" for updating. It also assigns 1 
as the logical file number which associ- 
ates this Р.І. with the current device. 
This way when Ifn 1 is specified in 
subsequent commands, the system 
knows which file on which disc to 
access. 


PRINT 


PRIX3,40:A$ 


Prints the ASCII string in A$ to record 
40 in Ifn 3. 


READ 


REA#3,40:A$ 


Reads binary data in record 40 in Ifn З 
and stores it in A$. 
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5 Command 


Example 


Result 


CALL “RENAME” 


z3 2-2 


CAL“RENAME”,1, 
“ PERSON- 
NEL/MGRS/ JONES”, 
“ PERSON- 
NEL/MGRS/ SMITH” 


Renames the file “JONES” under librar- 
ies “PERSONNEL/MGRS” on device 1 
to "SMITH." 


CALL “REWIND” CAL"REWIND",1 Rewinds pointer on the file associated 
, with Ifn 1 т an earlier OPEN command 
it | to beginning of file. 
SAVE 5АУ“ФВ10/ Transfers а current program to the file 
1 CHEMSTAT”; 100,- “СНЕМЗТАТ’” in library “B10” starting 
3150 with line 100 and ending with line 3150 
П іп binary format. If no file exists, the 
| command automatically creates it. 
^ ж ЗЕСВЕТ ЗЕС Prevents future program listing. 
Fd | 
CALL “SETTIM” CAL“SETTIM”, “4- Sets system clock to 20 seconds after 
П (SET TIME) | JUL-78 16:30:20” four-thirty PM on July 4, 1978. 
CALL “SPACE” CAL“ SPACE”, 3, Adjusts file space to 3000 bytes on the 
q 3000, A,B file identified as Ifn 3 т an earlier 
! OPEN command. Also generates two 
messages: the actual number of bytes 
7 required to store даа апа the actual 
number of bytes allocated. These mes- 
sages are stored in A and B, respec- 
n S tively. 
CALL “TIME” CAL“TIME”,A$ Sends the current system time to A$. 
TYP (function) T=TYP(2) Performs type function on file associ- 


222 =) 


2 


ated with lfn 2. 


See TYP command de- 
scription in the 4050 Se- 
ries Graphic System 
Reference Manual. 


4907 & EXTENDED MEMORY OPERATOR'S 


REV, OCT 1982 


MESSAGES 
Command Example Result 
UNIT UNI3 Specifies device 3 as the current 
device. 
CALL “UNIT” CAL"UNI'",B Specifies the device address in B as 


CALL "USERLIB" 
(User Library) 


the current device. 


CAL“USERLIB”, Causes "PORTLAND/INDUSTRY'" to be 
“PORT- the current library. Unless this current 
LAND/INDUSTRY” library is circumvented with special 


characters, the system will attempt to 
locate all files in “PORT- 
LAND/INDUSTRY.” 


WRITE 


WRI #3,40:A$ Writes the binary string in A$ to record 
40 in Ifn 3. 
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7 SAMPLE PROGRAMS 
! 


These programs аге useful іп general 4907 File Manager operation. They also 
n demonstrate typical use of many system commands. 
i 


1. RANDOM FILE INITIALIZING PROGRAM 


1 This is a two-part program. The first part prompts the user to enter start-up sequence 
information required on a day-to-day basis. This information is automatically entered 
П іп the commands shown іп the program listing below. Тһе program will: 
, МОТЕ 
П Time and date should be set first. Refer to page 5-90. 
110 Initialize the Graphic System. 
n 140 Designate the current device. 
150 Mount the device. 
"т а 190 Designate the current library (CALL “УЗЕВИВ”). 
Ж в 210 Specify the Fl 
270 Kill (деве) the file if desired. 
280-400 Create a random file and establish the number of records and record 
1 Н length. See CREATE command description for details оп determining 
record length. 
280-400 Create a sequential file if desired. 
П 430 Open the file. 


420-550 Enter blank strings in all records or random files. See Step 9 of GENERAL 
SEQUENCE FLOW CHART at the end of this manual. 


TET "IRANDOM FILE INITIALIZATION PROGRAM" 


100 
11@ INI 
П 120 PRINT "JENTER DEVICE ADDRESS: "3 
! 130 INPUT А 
140 CALL “UNIT", 
15@ CALL “MOUNT? AAS 
f| 160 PRINT "ENTER LIBRARY OR LIBRARIES CDOG/CAT>: "3 
170 INPUT A$ 
180 IF А$="" THEN 200 
4 190 CALL “USERLIB",AS 
I 200 PRINT "ENTER МАМЕ OF FILE:"; 
218 INPUT A$ 
220 CALL "FILE",0,8$,B$ 
Р 230 IF B$="" THEN 280 
a 240 PRINT "IF FILE EXISTS DO YOU WANT IT DELETED? (Y OR Н›:*; 
С^ 250 INPUT B$ 
260 IF BS<>"Y" THEN 200 
n 270 KILL A$ 
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B-2 


288 PRINT "ENTER RECORD LENGTH: "у SM 
INPUT а L 


300 PRINT "ENTER NUMBER OF RECORDS:"; 
310 INPUT В 

320 PRINT "IS THIS AN ASCII FILE? «Y OR НМ): "; | | 
330 C$="A" ы 
340 INPUT BS 

356 IF 9$-"v" THEN 370 


376 PRINT "OTHER ATTRIBUTES THAN "$C$}"RSN? ENTER CHARACTERS, ТЕ ANY: " 

380 INPUT B$ 

400 CREATE A$,B$ в,а ( 

А $ For the 4052/4054, this must be 400 CREATE A$ + + 

410 ТЕ Я=0 THEN 570 iii 28 

420 OPEN 6$;1,"F*,B$ 

430 DIM D$<A-1) T" 

440 0$="*" E 

450 FOR 1=1 TO й-1-4%(6$<>"А"> =- 

460 р$=р$&%" ” 

470 НЕХТ 1 ‚| 

480 IF C$="Q" THEN 530 | 

499 FOR I=1 TO В 

500 WRITE #1,1:D$ 
NEXT I 


528 GO TO 560 - 
930 FOR 1=1 TO B 
540 UE аы 


НЕХТ bid 
560 CLOSE 1 PES 
570 END = 


2. ASCII DATA TRANSFER FROM TAPE TO DISC FILE | | 


This program prints ASCII data from ап internal Graphic System tape to a specified 
sequential disc file. A description of significant lines follows the listing. 


INIT 
НЫН "LGGGITAPE TO DISC PROGRAM FOR DEVICE 0" | 


REM IS DATE SET OR DISC MOUNTED? 
CALL "TIME" T 
150 ТЕ A$<>"" THEN 190 $ 
160 PRINT "DATE AND TIME: "3 
17@ INPUT A 
18@ CALL “SETTIN", A$ | 
190 PRINT “JJINSERT DISC IN 4907 AND CLOSE DOORGG" ; 
200 РКІНТ "ond “RETURN’ WHEN READY 
218 INPUT A | 
220 CALL "MOUNT",@,B$ US 
230 PRINT “JENTER LIBRARY OR LIBRARIES (DOG/CATO: "3 - 


INPUT f$ 
250 CALL "USERLIB",R$ à 
260 PRINT ЕЕ SOURCE FILE NUMBER FROM TAPE: "; [1 


270 INPUT N - 
280 FIND N ( ) 
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Т«ТҮР(0; 
300 PRINT “ENTER NAME ОҒ DISC FILE ONLY: "; 
INPUT A$ 


CALL "FILE",0,8$,Bf 
IF В$="" THEN 39 
348 ЕКІНШІ АКЫШЫН EXISTING FILE DATA BE ERASED?CY OR N5:'4 


IF B$2"H" THEN 440 

OPEN 8$j1,"F",B$ 

380 GO TO 458 

ТеТҮР<0; 

ТЕ Т<2 THEN 

410 ДЕДІ» -1,10 

420 CREATE #3, 79; 256,0 

КЕМ ҒП.Е 512Е HILL BE INCREASED AS NECESSARY 
OPEN 6$11,"U",B$ 

450 ОМ 1. (85 THEN N 688 

468 GO TO Т ОҒ 498,510,540,570 
T *EMPTY FILE" 


6108 
490 PRINT "END OF FILE" 
610 


=з 
№ 
w 
© 


222 
ыы 
ATS) 
oo 


3 
ыы 
NO 
oco 


254 
һы 
ФФ 
оо 


222 
> > 
зо 
oo 


1 
P 
м 
© 
v 
20 
ке 
zd 


a 
№ 
® 
0 
о 
=“ 
2. 
= 
Е 
Lo 
т 
A 


60 TO 
READ @33:A 
WRITE #1:А 


ШӨ» | 
ena 
ФФ 
oo 


с 
e 
o 


0 TO 570 
PRINT "“JJDONE! GGG" 
END 


— 
жә 


1001МІТ 
Returns all variables in the Graphic System to an undefined state. 
120 UNIT O 


Tells the system that device O will contain the disc and will be the default or 
current device. 


140 CALL "TIME", А$ 


{ Requests the time indicated by the system clock and stores it in A$. 
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150 IF A$ < >“ THEN 190 


If A$ contains nothing or a null string, then 160 is executed. If A$ contains a time 
message, then 190 is executed. 


160 PRINT "DATE & TIME:"; 
Requests date and time; i.e.. 08-12-78 10:30:30. 
170 INPUT A$ 
System places the date and time entry in А$. 
180 CALL "SETTIM",AS 
Sets system clock. 
Now place the flexible disc in the 4907, close the door, and press RETURN. 
220 CALL “МООМТ”,0,В% 


Tells the system that device O is ready for use. A device status message is sent to 
B$. 


230 PRINT "JIENTER LIBRARY OR LIBRARIES (DOG/CAT):”; 


Requests the name of the library or libraries. If your file is directly under the first 
level file SCRATCHLIB, press RETURN. 


240 INPUT A$ 


This places the library name (or the null string resulting from pressing RETURN) in А$. 


250 CALL "USERLIB", A$ 


The library name in A$ is specified as the current default library. 


260 PRINT "ENTER SOURCE FILE NUMBER ON ТАРЕ:”; 


Requests the number of the file on the magnetic tape. 
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SAMPLE PROGRAMS 


270 INPUT N 
Places the number of the file in N. 
280 FIND N 
Locates the magnetic tape file specified in N. 
290 Т--ТҮР(0) 
Checks the type of information in the tape file. 
300 PRINT “ENTER NAME OF DISC FILE ONLY:”; 
Requests the name of the file. 
310 INPUT A$ 
Places the file name in A$. 
320 CALL "FILE", O, A$, B$ 
Selects the file named in A$ on the current device 0 and sends a file status 
message to B$. B$ must be dimensioned large enough to contain the status 
message. (DIMB$(200)). 
330 IF B$— “” THEN 390 
If B$ contains no message then 390 is executed. 
340 PRINT "SHOULD EXISTING DATA BE ERASED? (Y ОВ М):”; 
Requests status of current file information. 
350 INPUT В$ 
Y or Nis placed іп B$. 


360 IF B$ =“N” THEN 440 


If current file information is not to be destroyed, the file is opened with an update 
(U) access in line 440. 
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370 OPEN А6; 1, “Е”, B$ 


The file specified in A$ is opened for full access (F) and assigned the logical file 
number 1. 


400 IF T« 2 THEN 230 


If the TYP function in 390 returns an integer indicating a file not open or empty or 
EOF , then a new library name and/or file name must be entered. 


420 CREATE A$, T$; 256,0 
A new file is created at the location of the old disc file. Its name is the same as the 
name specified in 370. It is specified binary or ASCII, depending on the SEG 
command in 410. Line 420 specifies this file as a 256 byte sequential file. 
440 OPEN А$; 1, “Ц”, B$ 
Opens the file created in 420 for update access only. 
450 ON EOF (0) THEN 600 
Sets the flag so the progarm will end when end-of-file is reached. 
460 GO TO T OF 490, 510, 540, 570 
If end of file is encountered 490 then 610 are executed. 
If file contains numeric or character string data (ASCII) 510 is executed. 
If file contains numeric data (Binary) 540 is executed. 
If file contains Binary string data 570 is executed. 
480 GO TO 610 
If TYP encounters an empty file then 470 and 480 are executed. 
490 PRINT "END OF FILE" 
500 GO TO 610 


910 МРОТ @33:A$ 
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SAMPLE PROGRAMS 


520 PRINT #1: A$ 

530 GO TO 510 
The commands 510 thru 530 input the data from the tape file, one record at a time, 
to the Graphic System, print the data from the Graphic System to the disc file, then 


repeat through each subsequent record until EOF is encountered. 


Lines 540 thru 590 accomplish the same input/output functions as lines 510 thru 
530, but for different formats as described under line 460. 


610 END 


Closes all files and returns control to the Graphic System. 
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Appendix C 


SAMPLE I/O PROCEDURES 


USING PRINT AND INPUT IN A PROGRAM 


The following programs show how the PRINT and INPUT statements can be used to enter 
and then retrieve entire strings or numeric values within the strings. It is assumed that the 
files already have been created and opened. 


Retrieving Entire Strings From a Sequential File 


100 PRINT #3:“BLACK, TOM, 241 MAIN, MILL CITY, 5464451" 
110 PRINT #3:“BLUE, IRIS, 566 ELM, TWITVILLE, 6475579" 
120 CALL "REWIND",3 

130 INPUT #3:А$,В$ 

140 PRINT А$,В$ 


This program prints these strings on the screen: 


BLACK, TOM, 241 MAIN, MILL CITY, 5464451 


BLUE, IRIS, 566 ELM, TWITVILLE, 6475579 


Line 100 Stores all data shown (as a single string at.the beginning of logical file 
number 3). 
Line 110 Stores the data shown (as a single string following the previous string). 
Line 120 Returns the logical file pointer to the beginning of the file. 
| 
Line 130 Reads the first string from logical file number 3 and stores it іп A$; then 
n reads the second string and stores it in B$. 
| Line 140 Prints the contents of A$ and В$ to the screen. 
П 
n 
С 
П 
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Retrieving Numeric Values From a Sequential File 


100 PRINT #3: “BLACK, 200000” 
110 PRINT #3: "RED, 600” 

120 CALL “REWIND”, З 

130  INPUT #3:A,B 

140 PRINTA,B 


This program prints these values to the screen: 


Line 100 


Line 110 


Line 120 


Line 130 


Line 140 


200000 600 


Stores all data shown (as a single string at the beginning of logical file 
number 3). 


Stores all data shown (as a single string following the first string). 
Sets the logical file pointer back to the beginning of the file. 


Looks for the first numeric value in the file and stores it in A; then looks for 
the second numeric value and stores it in B. 


Prints the values of A and B to the screen. 
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Retrieving Numeric Values From a Random File 


100 
110 
120 
130 
140 


PRINT #3, 1: “BLUE, 150” 
PRINT #3, 2: “GREEN, 200" 
INPUT #3, 1: A 

INPUT #3, 2: B 

PRINT A, B 


This program prints these values to the screen: 


150 200 

Line 100 Stores all data shown (as a single string at the beginning of record 1 in 
logical file number 3). 

Line 110 Stores all data shown (as a single string at the beginning of record 2 in 
logical file number 3). 

Line 120 Searches through the string in record 1, locates the first numeric value, 

^ and stores it in A. 

Line 130 Searches through the string in record 2, locates the first numeric value, 
and stores it in B. 

Line 140 Prints the values of A and B to the screen. 

NOTE 


2 


Printing to a random ASCII file must be done carefully. If more data is 
transmitted than can be accommodated in the specified record, the data in 
the following record will be overwritten. 
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USING WRITE AND READ IN A PROGRAM 


The following programs illustrate how standard items can be written to a file, read out, 
assigned to target variables, and printed to the screen. It is assumed the files have been 
previously created and opened. 


Retrieving Both Strings and Numbers From a Sequential File 


100 
110 
120 
130 


WRITE #3:“RED”, "BLUE",145 
CALL "REWIND",3 

READ #3:A$,B$,A 

PRINT А$,В$,А 


The program prints these strings and this numeric value to the screen: 


RED BLUE 145 


Line 100 Stores the three data items at the beginning of logical file number 3. 
Line 110 Returns the logical file pointer to the beginning of the file. 
Line 120 Reads the first item and stores it in А$, reads the second item and stores it 


in В$ and reads the numeric value and stores it in A. If the target variables 
are out of order (for example, A, А%, В%, or А$, A, В%), an error message 
appears. 


Line 130 Prints contents of A$, B$, A to the screen in that order. 
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Retrieving Only Numbers From a Sequential File 


100 
110 
120 
130 


WRITE #3: "WHITE", 123, "RED", 456, “YELLOW”, 789 
CALL “REWIND”, 3 

READ #3: AG, A, А%, В, A$, С 

PRINT A, B, C 


The program prints the numeric values only: 


123 456 789 


Line 100 Stores the six data items at the beginning of logical! file number 3. 
Line 110 Returns the logical file pointer to the beginning of the file. 
Line 120 Reads each data item in turn and stores it in the specified target variable. 


“WHITE” goes to A$, 123 goes to A, and so on. The order of the target 
variables must match the order of the data strings, or an error message will 


appear. 
Line 130 Prints only the values of A, B, and C to the screen. 
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FILE POINTER OPERATION 


Since pointer locations may be altered only in sequential files, this discussion is limited to 
that type of file. For clarification, however, a table showing random file pointer locations is 
included. 


Each file is equipped with a "pointer." Although this pointer is invisible to the user, it tells 
the Graphic System where an І/О operation such as a READ or WRITE is to begin. When а 
file is created, the pointer is automatically positioned at the beginning of the file. Where 
the pointer is positioned after that depends on the access method ("F", “В” or “U”) 
specified in the OPEN command. For example, if data is being entered into a new file for 
the first time, an “F” must be specified in the OPEN statement. The pointer will start at the 
beginning of the file as shown in Figure C-1. 


END OF 
ALLOCATED 


BEGINNING OF FILE SPACE 


een: 
1 ВЕСІММІМС 


POINTER LOCATION 
2380-38 


Figure C-1. Graphic Representation of Files. 


Once data has been entered, the pointer remains where it was when data entry ended 


(Figure C-2). 
END OF 
ALLOCATED 
BEGINNING OF FILE END OF DATA SPACE 


i ! Ц 
МЕ 


ENDING POINTER LOCATION 1 


2380-39 


Figure C-2. Pointer Location at the End of Data Entry After an OPEN “F”. 
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SAMPLE I/O PROCEDURES 


The next operation may be started with an OPEN, with an “В” (READ), or with a “Ц” 
(UPDATE). If the “U” is entered іп an OPEN, the pointer remains at the end of the data. As 
data is entered, the pointer moves along until data entry is complete. The pointer is still at 
the end of the data, which in Figure C-3 is also the end of the file. 


END OF 
ALLOCATED 
SPACE 
BEGINNING OF FILE (END OF FILE AND END OF DATA) 


1 BEGINNING 


2380-40 POINTER LOCATION 


Figure C-3. Pointer location at the end of data entry after an OPEN “Ц”. 


If an “R” is entered instead of a “U,” the pointer is located at the beginning of the file 
(Figure C-4). 


END OF 
ALLOCATED 


BEGINNING OF FILE END OF DATA SPACE 


! 


1 BEGINNING 
POINTER LOCATION 
2380-41 


Figure C-4. Pointer location prior to І/О command after an OPEN “В”. 


READ may now be executed. When all the data has been read, an end-of-file message will 
be displayed.! This message indicates that the pointer has reached the end of the data. If, 
at this time, you wish to enter more data, you must execute a CLOSE and another OPEN 
with a “U” for UPDATE. 


1 when an EOF is encountered in a program, the program will abort unless an ON EOF command was 
executed previously. 
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Rewinding L 


Normally, the pointer cannot be moved backward to the beginning of a sequential file 
unless a CLOSE and a subsequent OPEN are carried out. There are, however, situations 
when convenient pointer movement is desirable, for example, when you wish to READ or 
reenter data just entered. A CALL “REWIND” command is provided to reposition the 
pointer to the beginning of the file; for example, if a user has completed data entry, the 
pointer would be located as shown in Figure C-5. 


r 


C 


— 
—— 


С 


BEGINNING OF FILE END OF DATA 


г 


ENDING POINTER 
LOCATION 


г 


2380-42 


Е 


Figure C-5. Pointer Location after Data Entry Before CALL “REWIND”. 


--- 


C 


If it is necessary to READ or reWRITE to the file, the CALL “REWIND” command can be 
executed. This will move the pointer back to the beginning of the file (Figure C-6). 


Cc 


BEGINNING OF FILE END OF DATA 


i 


p 


POINTER LOCATION 
AFTER CALL “REWIND” 
2380-43 


-— g 


Figure C-6. Pointer Location after CALL “REWIND”. 


The user may now execute a READ or WRITE without the necessity of a time-consuming 
CLOSE and OPEN. It is important to remember that if a WRITE is executed after a CALL | | 
“REWIND,” all data already in the file will Бе erased. 


( 
The following tables show the effects of “F”, “В” and “U” entries іп OPEN commands for I 
both sequential and random files. 
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Table С-1 


2224 


SEQUENTIAL FILE POINTER LOCATION 


Базе | 


Сһагастег Еп- Is PRINT or 
П tered іп OPEN WRITE AI- Initial Pointer Pointer Location 
| Соттапа lowed? Location When File CLOSED 
== 
Й Е (Full) Yes Beginning of file Current position 
Я В (Read) № Beginning of file Current end of data 
U (Update) Yes End of data Current end of data 
74 
| 
Table C-2 
" 
A RANDOM FILE POINTER LOCATION 
^ ^^ 
} | NE. Character En- Is PRINT or 
tered in OPEN WRITE AI- Initial Pointer Pointer Location 
1 Соттапа lowed? Location When File CLOSED 
| MN ERI "ЖЕСЕ T 
F or U (Full or YES Always at begin- Current end of data 
Update) ning of record 


specified in the 
МО command 
R (READ) NO Always at begin- Current end of data 
ning of record 
specified in the 
МО command 


нор 224 шз 


79 
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GLOSSARY 


Refers to number assigned to a particular disc 
device (device address) through setting of adjust- 
able strapping, or to a variable or to a file as 
indicated in an F.I. or by a Ifn. 


The act of communicating with a file, device, 
variable, etc. 


(American Standard Code for Information Inter- 
change) A standardized code of alphanumeric char- 
acters, symbols, and special control characters. 
Each character is represented by eight binary bits 
(a byte) in which seven of the bits distinguish one 
character from another and the eighth bit is re- 
served for parity checking purposes. The system 
ignores the parity bit in any ASCII characters it 
receives, and transmits low parity. (That is, it always 
transmits a O for the eighth bit.) 


The data in an ASCII file is a sequence of seven-bit 

ASCII characters. The high order bit is always set to 
zero. If a number is to be stored, it is converted to a 

sequence of ASCII characters. 


An area on the disc which, because of damage or 
surface defects, should not be used for storage. See 
CALL "FORMAT" and CALL "MRKBBG" command 
descriptions. 


An acronym derived from "Beginners All-Purpose 
Symbolic Instruction Code." BASIC is the high-level 
programming language used to command a Tektro- 
nix 4050 Series Graphic System. 

А binary digit; a 1 or a O. 


A group of eight binary bits. 


REV, OCT 1982 


GLOSSARY 


CHAINS 


CLOSED FILE 


COMMAND 


CONSTANT 


CONTIGUOUS FILE 


CONTROLLER 


CURRENT DEVICE 


CURRENT LIBRARY 


DEFAULT 


DELIMITER 


DEVICE 


The number of connections between a library at one 
level and the libraries or files on the following levels. 
The number of chains dictates the speed at which 
the system locates files. 


See FILE, OPEN. 


A line of instructions containing a keyword(s), 
address(es) and/or an argument. Usually issued 
from Grapihc System keyboard as contrasted to a 
statement which is issued from a program. 


Any entry in a field requiring a literal number rather 
than a representative variable. For example, the 
entry for the Ifn in a command that is not a “CALL” 
command must be an integer from 1 to 9 and not A, 
B, etc. 


A file that is not scattered over different locations on 
the disc but is contained within a single area. 


The device which, upon receiving instructions from 
the host, activates peripherals such as drives, 
plotters, printers, etc., depending on the interface 
within the controller. 


The device specified in a UNIT or CALL "UNIT" 
command. Unless otherwise specified, the default 
current device is device O. 

The library or libraries specified in a CALL "USER- 
LIB" command. The default library is 'SCRATCH- 
LIB." 


The value or values which the system may assign to 
the fields in a command when no entry is made. 


The character(s) or space(s) used to separate one 
field from another. 


A disc drive containing a disc. 
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The unique number assigned to a particular disc 
device through setting of adjustable strapping. 


A device available for any operation except format- 
ting (see DEVICE, RESERVED). 


A device reserved for formatting. 


Enlarging or reducing of string variable space to 
accommodate more or less than the 72 character 
default length. 


The recording medium used within a drive. Also may 
be referred to as the "volume", or when residing in 
the drive, the "device." 


A disc must be mounted before it can be accessed. 
The MOUNT command reads the device status 
message from the disc label, and informs the system 
that device is available. The DISMOUNT command 
disables the specified device until another MOUNT 
command is issued. 


See DISC, MOUNTED. 
The apparatus containing the disc. 


The number or character or string placed in a field 
or the variable or string variable representing it. 
Entries are made through program operation or 
keyboard. 


The status of the system when an incorrect entry or 
command is encountered; generally, when system 
error conditions occur, error messages are printed 
to the screen. 


The identifying "tag" placed on the end of file 
names. Extensions allow the system to distinguish 
between otherwise identical file names. 
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Р.І. 


FIELD 


FILE 


FILE IDENTIFIER 


FILE, LOGICAL END OF 


FILE, OPEN 


FILE, PHYSICAL END OF 


FILE POINTER 


File Identifier. Refers to the combination of library 
names and file names required when creating and 
locating files. Е.1.’$ are required in many system 
commands. 


A portion of a command or statement requiring a 
specific entry separated from preceding and subse- 
quent fields with delimiters. 


A collection of data, data items or program state- 
ments recorded on a storage medium. 


See ЕІ. 


An EOF mark is automatically placed at the end of 
all information entered into a file regardless of 
allocated space. When READ, INPUT or OLD com- 
mands are executed, this EOF is encountered and 
signals the controller that all information has been 
transmitted. This also may be referred to as END OF 
DATA. 


An open file is one from which data can be read or 
into which data an be written. Some commands 
that store (SAVE) or read (OLD, APPEND) program 
files do not need to have the file opened. 


A data file must be opened before it can be 
accessed (see OPEN command description in Sec- 
tion 5). When a file is opened, the file pointers are 
set and a logical file number is assigned. When a file 
is closed (see CLOSE command), the Ifn and file 
pointers are set to an undefined state. See also FILE 
POINTER OPERATION in Appendix C. 


The end of the space allocated to a file by the 
CREATE command. 


Although invisible to the user, the pointer dictates 
where an I/O operation is to begin. The pointer may 
be manipulated with an OPEN or CALL "REWIND" 
command. See FILE POINTER OPERATION (Appen- 
dix C). 
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HEADER 


HOST 


HOST BINARY 


KEYWORD 


LFN 


LIBRARY 


LOCKED FILE 


LOGICAL FILE NUMBER 


MASTER PASSWORD 


MEMORY 


MOUNT 
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The area preceding each binary data item describ- 
ing the following item as a string or numeric value. 
The header also indicates the amount of space used 
by the item. Standard items are placed into files only 
with a WRITE command. 


The Graphic System interfaced to the 4907 controls 
all system activity with the exception of system front 
panel switches. 


The Graphic System saves programs in either ASCII 
or binary form. The binary form is host binary, which 
means it can be entered only by another Graphic 
System. ASCII formats usually can be interpreted by 
all BASIC-based hosts. 


The entry in the first field of all system commands. 
The keyword tells the system the kind of activity to 
be carried out. 


Also Іп. The acronym for logical file number. 


A "directory" or "menu" containing the listing and 
location of subsequent libraries or files. A library 
itself cannot contain data or programs. 


A file that has been assigned a password in its Е.І. 


The integer from 1 to 9 assigned in the OPEN 
command that represents both the F.I. and the 
device address. Up to 9 files may be open at one 
time. Logical file O specifies the internal Graphic 
System magnetic tape. 


The master password entered in the CALL “FOR- 
MAT" command allows file access in CALL 
“МНКВВО” and KILL commands without use of 
specified passwords. 


The storage area in the Graphic System used to 
contain programs. 


See DISC, MOUNTED. 
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NUMERIC EXPRESSION 


OPEN FILE 


PASSWORD 


POINTER 


RANDOM ACCESS 


RANDOM FILE 


RECORDS 


RESERVED 


RELEASED 


SCATTERED 


SCRATCHLIB 


SEQUENTIAL ACCESS 


SEQUENTIAL FILE 


See 4050 Series Graphic System Reference 
Manual. 


See FILE, OPEN. 


The optional entry that may be placed in the F.I., in 
the CREATE command, immediately following any 
library or file name at any of the five storage levels. 
Subsequent access to files is prevented or limited 
unless the specified passwords are used. See 
PASSWORDS in Section 4. 


See FILE POINTER OPERATION (Appendix C). 


The method of storing or locating data by specifying 
a record number and directly accessing that record 
only. Opposite of sequential access. 


A type of file with two or more records of identical 
length. 


Two or more divisions of equal length in a random 
file. Number and length of records are specified in 
the CREATE command. 


Set for exclusive control, as in formatting or duplica- 
tion. See DEVICE, RESERVED. 


Freed from exclusive control. See RESERVED. 
The state of a file not in a contiguous form. File 
information is stored in scattered locations through- 


out the disc. Scattered files cannot extend over 
more than a single disc. 


The system name of the default current library. 

The method of storing or locating data by placing 
the file pointer at the beginning of the designated 
file and reading or writing towards the end of the file 


until required information is entered or encountered. 


A type of file with no divisions or "records." 
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SPECIAL CHARACTERS 


STATEMENT 


STORAGE STRUCTURE 


STRING VARIABLE 


SUBFIELD 


SYSLIB 


SYSTEM 


SYSTEM CLOCK 


TIME/DATE STAMP 


UNIT NUMBER 


USERLIB 


4907 & EXTENDED MEMORY OPERATOR'S 


GLOSSARY 


Characters that may be used to simplify file access, 
to provide multiple file selection or in multiple file 
name changing. See SPECIAL CHARACTERS in 
Section 4. 


А command preceded by a line number for program 
use. 


A collection of libraries and files. A storage struc- 
ture may be as small as a single file. 


See the 4050 Series Graphic System Reference 
Manual. 


If two or more entries may be made in a single field, 
they may be considered "subfields;" for example, 
the library and file names іп an F.I. are subfields. 


The system name of the 1st level system library. 
Generally used for storing commonly used public 
programs, data, etc. 


The "system" referred to in this manual includes the 
disc controller, the disc drive or drives, and the host 
(Graphic System). 


The device in the controller used to record the time 
and date of various device and file management 
activities. 


The time and date information that is automatically 
recorded on discs and files when device and file 
activity commands are executed. The system clock 
must be operating or no time/date stamps are 
recorded. 


The number assigned in a UNIT command specify- 
ing which device is to be the current device. 


The system name of the 1st level user's library. 
Generally used for any private data or program or 
that information specific to a particular subject. 
Unlike SYSLIB or SCRATCHLIB, USERLIB libraries 
can have any name desired: MYLIBRY, YOURLI- 
BRY, A, DOG, etc. 
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VARIABLE 


VOLUME 


VOLUME LABEL 


See the 4050 Series Graphic System Reference 
Manual. 


Refers to the storage medium used within the drive. 
Also may be referred to as the "disc." 


Wherever a disc is formatted, a "label" is automati- 
cally created, containing information about that disc. 
See DEVICE AND FILE STATUS MESSAGES (Ap- 
pendix A). 
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Раде || 
CALL ПІЗМООМТ........................................ Е-4 
CALL “БВЕТ”............................................ Е-5 
CALL “DRES” T анда e ам а салына Е-5 | 
CALL “БЗКЕНН”......................................... Е-5 
CALL *DSTAT" .......................................... E-5 
CALL “DUP” лань ы ento E-5 Ц 
CALL “ҒЕНВМТ”.......................................... Е-5 
CALC FILE” кеф RR E RU E Rm eels aa es E-6 
CAL EU SEMVALS ИТ ТЕГ 2 Е-6 1 
CALL "FORMAT" ........................................ E-6 
CALL “НЕНН5”.......................................... E-6 
INPUT ооо ое IE en AS E-6 d 
IEEE ERU E-7 
CALL “MOUNT” ......................................... E-7 
CALL “МВКВВО”........................................ E-7 || 
CALL "NEXT". ори E-7 
CALL “OFFERR” sed eye ER» HER rtp Ert ная E-7 | 
ОГО MEET Е-7 
ОМЕОЕ 2228 o Rh ERREUR RR asd A etx Re sere ete E-7 
CALL “ОМЕНВН”?.......................................... E-8 || 
OPEN: usen CERERI M S TRIN eee E-8 VW J 
PRINT erect E ATE oe E S AEE E-8 
ЕАО TO И Е-8 |) 
CALL “RENAME” ........................................ E-8 
CALL “ВЕУЛІМО”......................................... E-8 
COO MCN ро ARA TS A E-8 || 
©ЁСНЕТ, у: bx Зоры ae Ree Bere Е-8 
CALL *SETTIM" ......................................... E-9 
CALE “SPACE? is oer vetere Se nra нек ия E-9 | 
CALG TIMET ола ааа та ае nr дее МАНУ Е-9 
ТҮРЕ; У нона ОТ УГ СЕ Е-9 І 
UNIT Aet rro vc br bx О КОО Л ОУ ГЫ E-9 || 
CALL UNIT ааа ев Е-9 
CALL. “USERLIB” ходе eves ак ten eme erm xe nens E-9 
WRITE: x core eem құлда tar uere erani le Oh de ing E-9 || 
Status Меззапев.....................................ӛ...... Е-10 
Сһагасіегівісв............................................. Е-10 
[У [О Е-10 | 
Electrical Power УОваде................................... E-11 
Storage Capacity ...-...... есь ааа aee E-11 1 
Data Transfer НБайе....................................... Е-11 
Stored Data Retention Time .............................. E-11 «У, | 
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Appendix E 


4052/4052A & 4054/4054A OPTIONS 27 & 28 


EXTENDED MEMORY FILE MANAGER 


INTRODUCTION 


Option 27/28, the Extended Memory File Manager, appears to the computer system to be 
similar to Unit 4 on a 4907 File Manager. In most cases, programs that run using a 4907 
will run with little or no change using the Extended Memory. 


The Extended Memory File Manager uses a set of commands which is (with a few 
exceptions) a subset of the 4907 File Manager commands. This appendix contains a list 
of the commands and gives details of those which are not supported, or act in a different 
way. When the commands act like the 4907 command, this fact is noted. For full details on com- 
mand operation see Section 5, COMMAND DESCRIPTION. 


The Extended Memory File Manager operates by intercepting all commands and 
examining them to see if they are intended for the Extended Memory. Whenever a 
command is not recognizable, the Extended Memory File Manager takes one of three 
actions: 


1. Whenever another File Manager or system is connected, the Extended Memory 
attempts to pass the command on to the next File Manager. 


2. When the Extended Memory cannot pass a command on, if at all possible, it 
ignores the command and does nothing. 


3. Ifthe command can be neither passed on nor ignored, the Extended Memory 
File Manager will issue an error message. 


Option 27 or 28 contains a standby power supply and battery pack to maintain the 
information stored in the Extended Memory should the computer system be turned off or a 
power loss occur. The Extended Memory will retain information indefinitely as long as the 
power is connected, and a minimum of 4 hours should the power fail. 


The Extended Memory File Manager is available either installed at the factory, or may be 
installed in the field. The Extended Memory is installed directly on the computer and the 
user need not be concerned about GPIB connections. 
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STORAGE STRUCTURES 


The Extended Memory File Manager does not support multiple level storage structures. 
File Identifiers are recognized as a single level structure (illustrated in Section 3, 
Figure 3-2). 


SPECIAL CHARACTERS 


The special characters “%” and “?” have the same meaning as on the 4907. “@” апа “$” 
are not supported, and “#” is ignored. 


The Extended Memory File Manager “folds” a multiple level storage 
structure to a single level by ignoring library names. This can cause two 
files with the same name which were in different libraries to be seenas a 
single file. І.Е. files named "A/B/C/D", "L/L/L/L/L/L/D", and "D" are all seen 
as file "D" on the Extended Memory File Manager. 


DEFAULT DEVICE 


When you have a 4907 or 4909 connected to the computer system, the default device is 
Unit O. If you issue the command OLD, INIT, or DELALL while the current device is Unit 4, 
after the command has completed, your current device will be Unit O. However, when only 
the Extended Memory is installed, the current device remains Unit 4. 


LOGICAL UNIT NUMBER ASSIGNMENT 


Some conflicts may arise due to the fact that the Extended Memory File Manager 
examines commands and executes those which it recognizes. A file may be assigned a 
logical unit number on a 4907, and a different file assigned the same logical unit number 
in the Extended Memory. The Extended Memory and 4907 maintain separate logical file 
assignment lists and do not communicate them. 


In addition, the Extended Memory does not allow “group opens" and will intercept a NEXT 
command even if the command is meant for an attached 4907. 
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COMPATIBILITY FILE TYPE 


The Extended Memory supports a new file type, type “О”, the compatibility file type. The 
compatibility file type is used for accessing array data one element at a time. 


In a 4907 or 49089, a binary array is read or written one array unit at a time. In the 
Extended Memory, to increase speed, a binary array is read or written as an array of data. 


Some applications of the 4907 and 4909 use “опе element at a time" read and write in 
order to move data between different sized arrays. In the Extended Memory, in order to 


manipulate array data one element at a time (with reduced speed), you can use a file 
which was CREATED as type “О.” 


COMMANDS 
APPEND 


APPEND operates like the command on a 4907, except the Extended Memory does not 
support multiple library levels or passwords. 


ASSIGN 


The Extended Memory does not do an assign. This command is treated as a “no-op.” No 
action is taken, and no error message is given. 


CLOSE 


CLOSE operates like the command on a 4907. 


CALL *COMPRS" 


CALL "COMPRS' is a “по-ор.” 
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COPY...TO 


COPY...TO operates with certain limitations. The Extended Memory File Manager will copy 
only to itself. A 4907 does not know about the Extended Memory File Manager and cannot 


copy to it. 
Therefore, when using COPY...TO, either both Device Addresses (source device address 
and target device address) must be Unit 4, or neither Device Address may be Unit 4. 


(Devices Addresses other than Unit 4 are passed to the 4907, if present.) 


You must use an application program to copy files between the Extended Memory and 
another device. 


CREATE 


Operates as documented with a 32767 byte record limit for random files. The Extended 
Memory File Manager will allow you to specify only file types "A","B","H", and “О” (the 
new compatibility file type). 


For more information on the compatibility file type, refer to the discussion earlier in this 
Appendix. 


CALL “CUSTAT” 


Operates like the command on a 4907. 


DELETE ALL 


Operates like the command on a 4907. 


DIRECTORY 


Operates like the command on a 4907. 


CALL DISMOUNT 


Dismount is а “по-ор.” (The Extended Memory cannot be dismounted.) 
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CALL “DREL” 


221222 


“DREL” is а “по-ор.” 


ча 


CALL “DRES” 


2a 


“DRES” is a “no-op.” 


CALL “DSKERR” 


CALL “DSKERR” is not supported on the Extended Memory File Manager. 


bon Me ша 


CALL *DSTAT" 


Operates like the command on a 4907. 


CALL “DUP” 


ca 


Passed to the external device if Unit 4 is not mentioned. May not be used between the 
Extended Memory and another device. 


END 


Operates like the command on a 4907. 


CALL *FFRMT" 


Only the unit number has meaning. The other arguments are treated as “по-орз.” They 
may be omitted if you wish. See CALL “FORMAT” for further information. Call “FFRMT” 


cannot fail. 
NOTE 
Fast Format simply sets up the data structure. It does not clear 
parity errors. 
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CALL “FILE” 


Operates like the command on a 4907. 


CALL “FMVALS” 


Anything but a valid 4907 unit will cause the target string variable to be returned as 
NULL (‘”). 


CALL “FORMAT” 


CALL “FORMAT” requires only the first argument (unit number). The remaining 
arguments are “по-орв.” The Extended Memory always establishes eight directory 
chains. 


CALL “FORMAT” may return a parity error (error 52, Device I/O error). If repeated CALL 
“FORMAT” commands do not clear the parity error, turn the power to the computer off, 
then on again. 


Whenever the computer is powered up, it examines the Extended Memory to see if it is 
formatted. If the power up routine finds parity errors, or an unformatted memory, it 
immediately formats the memory. 

If several tries to format the memory fail, and the power up routine does not clear the 
parity errors, call your Tektronix Service Center. 

CALL *HERRS" 

The first three returned values are meaningless to the Extended Memory, and are always 
returned as О. The number of unsuccessful 1/0 errors is a count of device I/O errors that 
have happened since the last formatting. 


INPUT 


Operates like the command on a 4907. 
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KILL 


Operates like the command on a 4907. 


CALL “MOUNT” 
“Mount” is meaningless to Option 27/28 and is essentially a “по-ор.” The External 


Memory cannot be dismounted and is "mounted" at power up. However, “MOUNT” will 
return the device status message in the target string variable. 


CALL *MRKBBG" 


Call “МАКВВС” allows a user to mark а block as used if he knows that a specific block is 
causing 1/О errors. If the block is already used, MRKBBG will fail. “/Volume/ID” and 
“/Master password” must be given, but they are ignored. “Address of Defective Space” in 
hex must be as listed. Error message 15 in Option 27/28 does not return an address. The 
address must be calculated. 


CALL “NEXT” 


The Extended Memory does not allow group opens. This command is meaningless 
(“по-ор”). 


CALL “ОҒҒЕНН” 


CALL “ОҒҒЕНН” is not supported on the Extended Memory File Manager. 


OLD 


Operates like the command on a 4907. 


ON EOF 


Operates like the command on a 4907. 
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CALL *ONERR" 


a 
— ee 


Г 


CALL “ОМЕВВ” is not supported on the Extended Memory File Manager. 


OPEN 


г—. ЖО 


Operates like the command оп а 4907 except that group opens аге not allowed. It will 
return an error if a group open is attempted. The Extended Memory File Identifier 
restrictions apply. 


CZ 


PRINT 


p 


Operates like the command on a 4907. 


С 


ВЕАО 


= 


Operates like the command оп а 4907. 


CALL “RENAME” 


I 
Operates like the command on a 4907. (File Identifiers must conform to Extended Memory || 
File Manager requirements.) 


CALL “REWIND” 


— 
Se 


{ 


Operates like the command on а 4907. 


SAVE L 


Operates like the command on a 4907. 


C 


SECRET Ц 


Operates like the command оп а 4907. 
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CALL “SETTIM” 


Is passed to the 4907 if опе is attached. Otherwise a “по-ор.” The Extended Memory 
does not require any clock to be set. 


CALL “SPACE” 


Operates like the command on a 4907. 


CALL "TIME" 


Is passed to 4907 if one is attached. 


TYP 


Operates like the command on a 4907 with a small addition. If the file is a binary file and 
an array, item TYP will return type 3 (numeric data binary format). 


UNIT 


Operates like the command on a 4907. (The Extended Memory is Unit 4. 


CALL “UNIT” 


Operates like the command on a 4907. 


CALL “USERLIB” 


Will be passed to a 4907 if one is attached. Otherwise it will be a “no-op.” 


WRITE 


Operates like the command on a 4907. 
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STATUS MESSAGES 


The format of the messages is generally the same as 4907 messages. (The same fields 
аге in the same places.) If the Extended Memory does not supply the data in a field, it 
does not supply the labels. 


For example, the file status messages do not contain time-date fields, or the labels for 
these fields. 


The Extended Memory returns data in the following fields: Device ІО, Free, Size, Block 
Size, Files Open. All other fields are left blank. 


An unformatted 4907 disk and the Extended Memory File Manager return the same 
Device Status Message: 


“00-ХХХ-00 00:00:00 FORMATTED” 
As it is unformatted, the Extended Memory returns the 4907 Device Status Message. 
A formatted 4907 disk has the “О” and “Х” fields filled out. For example: 


“23-JUL-96 11:11:11 FORMATTED” 


The Extended Memory File Manager, when formatted, does not fill out the time-date fields: 


FORMATTED” 


CHARACTERISTICS 


For full specifications see the Option 27/28 Extended File Manager Service Manual. The 
specifications which follow are partial only and do not supersede those in the Service 
Manual. 


Physical 
Option 27/28 consists of several circuit boards housed in a 4-slot backpack, a power 


supply mounted under the computer keyboard, and the necessary cables and hardware 
for installation. 
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Electrical Power Usage 


Operating: + 15VDC = 5%, 300 to 500 ma. 
90 to 264 VAC, 0.5 A, 48 to 66 Hz 


оса раев 


ра | 


Standby: 90% 264 VAC, 0.5 A, 48 to 66 Hz 


— 
Pd 


Storage Capacity 


ZA 


Option 27: 261,632 bytes 


ша 


Option 28: 523,776 bytes 


Data Transfer Rate 


4052/4054 50K bytes per second maximum. 


зл 4 


4052A/4054A 400K bytes рег second maximum. 


1 
2 


Table E-1 
STORED DATA RETENTION TIME 


Condition | Data Retention Time 
П 4050 System Power Switch ON. 
System plugged into a live ac power line. Indefinite 
П 4050 System Power Switch OFF. 
System plugged into a live ac power line. Indefinite 
1 4050 System unplugged from 4 hours minimum (starting 
ac power line or power failure. with fully charged batteries) 
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1. Set System Clock 


The CALL “SETTIM” command starts the system 
clock so the time and date of various system 
activities are recorded. It is required each time 
the system is powered up. There is по "default" 
time provided. 


2. Choose Device 


The UNIT command identifies the “current” dev- 
ice. The system accesses the current device 
whenever it receives a command that does not 
specifically name some other device. The address 
to be used in this command can be seen on or 
around the face of the device. Device 0 will 
always be accessed if no UNIT command is 
executed. 


3. Has Disc Ever Been Formatted? 


All discs must be formatted before they are used 
for the first time or when all existing information 
is to be replaced. If the disc already has been 
formatted and has valid volume label information, 
no formatting is necessary. CALL “MOUNT” noti- 
fies the system that there is a formatted disc 
ready for use. 


4. Reserve Device 


You must reserve the device with CALL "DRES" 
before formatting can take place. 


5. Format Disc 


The disc may now be formatted with the CALL 
"FORMAT" command. This command also exe- 
cutes an automatic CALL “MOUNT” to notify the 
system that there is a formatted disc ready for 
use. 


6. Release Device 


The reserved device must now be released with a 
CALL "DREL" command. If the device is not 
released, no files can be opened. 


7. Is Device Status Message Nec- 
essary? 


If you wish to confirm that the correct disc is in 
the drive, or what the specifications of that disc 
are, you may execute a CALL “ОЗТАТ” command. 
This also allows you to see if the disc has been 
formatted. 


At this point, preparatory work involving the disc 
is complete. Steps 8 through 16 show commonly 
used file operations on a disc prepared as shown 
in steps 1 through 7. 


Activate Device 


Set System Clock 


CALL *SETTIM" 


Choose Device 


UNIT 


Has Disc Ever 
Been Formatted 
? 


Yes 


Reserve Device 


CALL "DRES" 


Format Disc 


CALL "FORMAT" 


Release Device 


CALL "DREL" 


Is Device 

Status Message 

Necessary 
? 


Yes 


CALL “ОЗТАТ” 


CALL "MOUNT" 
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8. Has File Already Been Created? 


If you wish to store information and no file has yet 
been created to receive it, you must execute the 
CREATE command?. This command allows you to 
specify the name of the file and its attributes, the 
length of the file, the number of logical records 
the file will contain, and whether the file is 
random or sequential. 


9. Has File Been Initialized? 


Although information may be “randomly” read 
from a random file, it must be entered sequen- 
tially unless the records are first filled with “blank 
strings.” See file initializing program in the sec- 
tion SAMPLE О. This program enters blank 
strings into a file, allowing random data entry. 


10. Is File Operation to be SAVE, 
OLD, APPEND or COPY ... TO? 


The above operations may be carried out without 
the OPEN and CLOSE commands. 


11. Open File or Files 


An OPEN command must be executed for those 
file operations listed in Step 13. This command 
assigns a logical file number (Мп) to the file, sets 
file pointers, and generates and stores a file 
status message for each file opened. Another 
UNIT command, as in Step 2, is necessary to 
access a file on a different device. 


12. Is a File Status Review Neces- 
sary? 


It may be necessary to review the status of the 
file or files just opened. The parameters include 
the time and date the file was created, altered, 
and last used, as well as its name, attributes, and 
space specifications. To see what details are 
included and how they are displayed, turn to 
SAMPLE DEVICE AND FILE STATUS MESSAGES. 
If you do wish to review the file status, enter the 
string variable that was specified in the last field 
of the OPEN command. 


ЗЕхсері for a SAVE which can create its own 
file. 


No 


Has File 
Already Been 
Created? 


Yes 


CREATE 


No 


Execute File 
Initialization 


Program 


Yes 


Enter the 
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Containing 
the Status 
Message 


Has File 
Been 
Initialized? 
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СОРҮ.ТО? 
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APPEND or 
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Figure 2-6. General Sequence Flow Chart. 
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Is It 
Necessary 
to Close 
the File? 


14 


is It 
Necessary 
to CREATE or 
Access Another 
File on the 
Same 
Device? 


15 


Deactivate the Disc 


CALL “DISMOUNT” 


Yes 


Yes 


A Variety of 


File Management 


and File I/O 


Commands Possible: 


READ 
WRITE 
PRINT 
INPUT 

REWIND 


CLOSE 


Go Back To 
Step 8 


13. Is File Empty? 


If the file has just been created, it contains no 
information. Information may be entered into the 
file using а WRITE or PRINT command. 


If the file is full or partially full, as indicated in a 
file status message, you may execute a variety of 
file management and file I/O operations: 


WRITE ... for entering binary information 
PRINT ... for entering ASCII information 


READ ... for retrieving binary information 
INPUT .. for retrieving ASCII information 


CALL “REWIND” resets the file pointer to the 
beginning of the file. 


These commands are used to carry out some of 
the more common file management operations. 
The command descriptions in Section 5 tell, for 
each command, if the file must be open or closed 
for command execution. 


14. Is 
File? 


It Necessary to Close the 


If no further file access is needed, the file can be 
closed by executing a CLOSE command. This 
releases the logical file number (Пп) and stops 
access to the file. it is not necessary to close the 
file in order to open another, because up to nine 
files may be opened and used simultaneously. DO 
NOT CLOSE A SEQUENTIAL FILE OPENED FOR 
FULL ACCESS WITHOUT WRITING TO IT OR 
THE FILE CONTENTS WILL BE LOST. 


15. Is It Necessary to CREATE or 
Access Another File on the Same 
Device? 


Your operation may require placing data into or 
retrieving data from more than one file at a time. 
To access or create another file on the same 
device, go back to Step 8. If no further access to 
this device is desired, it can be deactivated by 
executing CALL "DISMOUNT." All files must be 
closed before executing this command. If you 
want to access a file on a different device, go 
back to Step 2. 
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